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eelitorial 


Three news stories have dominated the QL scene this year, one of which you will be 
reading for the first lime in this issue of QL Today, Volume {7 will be our final volume. 
Issue 4 will not be published in the Summer, but will be postponed until the Autumn. This 
is lo give us lime to scan volumes 16 and 17 so that readers can have a complele 
electronic archive of every issue of the magazine. 


- by Gaol Wicks 


Another of the news stories is a sad one, although not unexpected. In this issue we re- 
port the death of Bill Richardson, one of the unforgettable characters of the QL commu- 
nity. Most of us have our own memories of hirn. Bill once gave me a minor rebuke for 
something | wrote in the very first issue of QL Today. | had suggested that most QL 
software authors do not charge for their labour, and, ever the trader, Bill told me that | 
should. 


The third news item is more pleasurable with the release of a new QL product, SMSQ- 
mulator. It has excited much interest in the QL community with a continuing discussion on 
the QL-users email group. Indeed it brought out the best in the group and showed how 
much we need it. For several days, if not weeks, there was inslant feedback on the pro- 
gram including bug reports. These were quickly followed up by SMSQmulator author 
Wollgang Lenerz, who was constantly updating the program. Wolfgang has given the QL 
community a morale boost and shown that there is stil a great deal of life in the QL. 


To return to QL Today. When Jochen phoned me with the proposal to make this the last 
volume of QL Today, | had little difficulty in agreeing. Although we have been blessed 
with some very faithful writers for whom we are grateful, they were, unfortunately, far too 
few in number. | had a constant nightmare of losing just one writer and then being unable 
to fill the magazine. 


When the readers pay thelr subscription, we have a duly to produce a quality product. 
Without more writers | could not guarantee continuing to do so. Like Jochen | would 
rather close the magazine while it is still relatively strong than struggle on before finally 
letting our readers down. 


To our present writers | would like to say a special thank you, During this volume you 
have often provided your copy well before the deadline date. This took a lot of pressure 
off Jochen and myself as we started work on each new issue. 


Let us not be downhearted by the closure of QL Today. There is a long QL tradition of 
new initiatives being started when something closes down. QL Today itself rose [rom the 
ashes of IQLR, and has survived longer than any other QL publication with the exception 
of the Quanta Magazine. 


The future will not, however lie in a printed magazine. The economics are against it. For 
example, producing the Quanta Magazine took up half of Quanta’s income last year and 
almost two thirds the year before. It was one reason Quanta had to raise ils subscription 
and introduce a postal supplement for UK members. 


The future could lie in some form of web initiative. There is and will remain a need for 
more in depth QL articles and information than is possible in either the QL-users email 
group or the QL forum. 


There can be life after QL Today, The challenge is there. Who will take it up? 


News 


NEW JAVA EMULATOR 


The New Year brought with it a new SMSQ/E 
emulator which Wolfgang Lenerz released to- 
wards the end of January. SMSQmulator is a 
Java emulation of SMSQ/E and raises the possi- 
bility of some form of QL platform on portable 
devices. The emulator runs at about one tenth of 
the speed of QPC2 for multicore processors, but 
much slower on single core systems. 

The emulator dominated discussion on the QL 
users email group for about 3 weeks after its 
release with contributors praising the quality of 
the product and reporting very few bugs and 
program incompatibilities. Wolfgang has quickly 
responded to any bug reports and since its first 
release there have been several updates posted 
on his website. 

SMSQmulator is intended purely as an SMSQ/E 
emulator and thus is not compatible with pro- 
grams that can only be run on native hardware. 
The emulator can be downloaded from: 
www.wlenerz.com/SMSQmulator 

The web address is case sensilive. 


' , 
Dilwyn Jones’ Updates 
Dilwyn Jones has a long list of updates and new 
products that can be downloaded from his site: 


ROCKFALL and MANDELSPEED 
NOW FREEWARE 


Originally written by Andy Toone, this colourful 
Boulderdash style arcade game from the 1980s 
is now available as freeware alter Rich Mellor 
secured permission from the author | have made 
it available for download in two versions, one for 
QemuLalor which can be run direct from the zip 
file by linking the zip file to one of the QemuLator 
drive slots (the zip file contains a BOOT program 
which should allow it to start aulomatically from 
the zip file when.the emulation is started) and a 
second version without QemuLator file headers, 
which prevented it running on other QL systems. 
Note that although i! seemed to run fine on 
Minerva ROM with QemuLator, | was not able to 
get it fo run in SMSQ/E on QPC2. In the game, 
you have to move around through the dirt col 
lecting diamonds while avoiding falling boulders 
and monsters which chase you. 


Download this game from 
http://www.dilwyn.me.uk/games/index.html 


i : rae 


A Mandelbrot graphics plot tool called Mandel- 

speed from the same author is also now free- 

ware and comes in separate versions for Q-emu- 

Lator and other QL systems. 

Download both versions from 

http://www.dilwyn.me.uk/graphics/index.html 
ns te ee aT lle 
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PCB DESIGN UPDATE 


Malcolm Lear has released a further update to 
his PCB designs software. Version 7.25 updates 
include, according to Malcolm: ‘The biggest im- 
provement with this version is the editing and 
viewing of the NC drill sizes. ‘h’ toggles the 
screen view on/olf and ‘Cir h’ starts up a drill 
edilor’ 

Download this latest update from the Graphics 


page on my website a 
http://www.dilwyn.me.uk/graphics/index.html 


PROJECT GC QL MOUSE 


Gianni Carugno has released a project to build a 
mouse system for the QL. The ‘GC’ in the project 
name refers to his own initials rather than Gold 
Card. The set of PDF files contain circuit diagram, 
paris list, PCB layout, adapter lead details, 
firmware etc for building this project, which 
interfaces a PS/2 style mouse to a QL CTL port 
to emulate cursor key presses, like a QL joystick, 
This project is completely free to download. The 
author says that although a USB style PS/2 
mouse can be used (usually one supplied with a 
PS/2 to USB adaptor) a purely USB mouse may 
not work. Gianni says that power may be taken 
from the QL EPROM slot (see the picture below) 
or via a low power PSU if you preter. 

Download it from the Hardware Docs page at: 
http://www. dilwyn.me.uk/docs/hardware/index.html 

[ED: A review of this project appeared in QL 
Today vi7 12 p6] 
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ITALIAN PSIONS 
Yo add to the British, American and German 
versions of QL Quill, Archive, Abacus and Archive 
already available on the Dilwyn Jones QL 
website, there are now Italian versions available 
too. Download version 2.23 of them from: 
hitp://www.dilwyn.me.uk/psions/index.htm! 


BLOCKWALL GAME 


Gianni has also been busy writing a 
Breakoul-style game called BlockWall. He says it 
is his first QL game written in the Pascal 
language, The game runs on QemuLator but it is 
bes! to set the emulator to run at OL speed if it 
is used on a fast computer. 

BlockWall is available {o download from the 
Games page at: 
http://www.dilwyn.me.uk/games/index.html 


QaLendar 2013 

My annual QL-themed calendar, The QaLendar, is 
now available for 2013. 

It may be downloaded free as a PDF or Word 
2010 file from 
htip://www.dilwyn.me.uk/gen/calendar/calendar.htmi 
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Sjef van de Molengraaf (secretary of the Dutch 
QL group Sin_ 
QL_Ain) has 
senl me an al- 
ternative —ver- 
sion, available 
from the same 
page. 

More — calendar 
utilities (including 
SuperBasic pro- 
grams to help 
creale your own 
calendar) are 
available — from 
the Utilities page 
on the websile 
http://www.dilwyn.me.uk/utils/index.html, 


FRANK’S SPRITE GENERATOR 
FSG is a sprites package for QL SuperBASIC, 
written by Frank Linder: in Sweden. FSG stands 
for ‘Frank's Sprite Generator’! It was written in 
the 1980s but never released commercially. Frank 
has now given permission for it to be released 
as Freeware. 
The package includes an icon editor, screens 
editor and music editor along with some very 
playable sample demo games including Heli {a 
helicopter game}, Aste {based on Asteroids), 
Grott {a cave/mounlain adventure game) and 
Combat (2 player helicopter game). Note that the 
package only runs on a system with QL mode 8 
screen resolution and colour mode, with system 
variables at the address of an original QL system. 
Sprite control is via a comprehensive set of 
BASIC extensions, crealing games which can run 
interpreted in SuperBASIC and compilable with 
Q-Liberator. 

The zipped package is a 120KB free download 
from the Games page on my website at 
http://www.dilwyn.me.uk/games/index.htm| 
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QL ADVERTISING FONT 


If you'd like a font which resembles the font used 
in original Sinclair advertising - the well known 
large letters ‘QL’ for example - | have now added 
one to my website. It may come in useful for QL 
devotees wishing lo recreate historical articles 
about the QL, for example. Following a request 
made on QL Forum, Anthony Prime said it is a 
font called Saxony-Serial-Regular. 

Download Windows True Type font. Type 1 and 
Line Design versions from the Fonis page on my 
websile al 

http://www.dilwyn.me.uk/fonts/index.htm! 

On the same page you can also gel a font de- 
signed by Lee Privelt which will lel you repro- 


duce the QL screen font in a word processor 
document, along with the square characters used 
for the Sinclair logo - these fonts may come in 
useful if you wish to reproduce historical QL and 
Sinclair documents. 


Sinclair QL 
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QUANTA NEWS - 
Tandata Modem Software 


Many years ago, Quanta was able to supply the 
old Tandata three-stack modem systems for the 
QL. These were available with enhanced soflt- 
ware, which included a cut-down version of the 
Qualsoft terminal programs from TF Services. 
Thanks to Rich Mellor who was able to locate a 
copy, and with thanks to Tony Firshman for con- 
firming we can still supply it to members, this 
software can again be made available for those 
who wish to try out these classic modem sys- 
tems on a QL, as they do become available on 
eBay and SellMyRetro from time to time. The 
software ts nol part of the Quanta library, rather it 
wil be held by Treasurer John Gilpin should any 
member wish to obtain a copy. The software is 
free of charge to members. 


Other Software 


GWASL 

George Gwilt writes: 

‘Norman Dunbar has found a fault in GWASL 
which affects the reporting of errors in labels. 
This is corrected in version 2.05 which can be 
downloaded from my site at 

http://gwiltprogs.info/ 


SMSQ/E MOVE 

Wolfgang Lenerz writes: 

“SMSQ/E v. 3.14, with the new licence, has been 
moved to: 

www.wlenerz.com/smsqe 


There isn't really much that is new in 3.14, except 
that it contains the SMSQ/E code for SMSQ- 
mulator - no need to upgrade except for that.’ 


From the Distant Past 

QL Today's editor has received an email from 
Stephen Denson, a former trader from the ear- 
liest days of the QL. He sold business software 
including QL Invoicer Stephen has recently 
bought some back copies of QL Today on eBay. 
He comments: 


BILL RICHARDSON 


Bill Richardson, one of the most 

respected and liked former QL Tra- 

ders, has died aged 94. 

Bill had an association with the QL 

from the earliest days and con- 

tinued trading until 2006. In a 2002 

video interview with Darren Bra- 

nagh he tells of his link to Clive 

Sinclair starting from the latter's 

pre-computer days. Both were involved in digital 

watches, and at one stage Bill was a rival trader. 

Bill's involvement with Sinclair products started with 

the Spectrum. He estimates that there was a return 

rate of between 8% and 15% and Clive Sinclair had 

made no provision for their repair. Bill took over the 

responsibility as an intermediary and arranged for the 

returns to be repaired and resold. 

Initially he was involved in the QL in a small way buying 

and selling about 50 at a time. However he seized his 

opportunity when a large QL order destined for Iran 

collapsed and he was able to buy 4,000 cheaply. In 

later years he mainly traded in ZX88's, 

The video interview can be viewed on YouTube: 
http://youtu.be/P3CwlineYZ4 

Many tributes were paid to Bill on the QL users email 

list. In announcing Bill's death Tony Firshman repor- 

ted: 

“He and Felix Fonteyn (brother of Dame Margot) were 

responsible for many thousands of effectively new 

QLs, made from ex-Sinclair stock. He negotiated a 

batch of new QL membranes from the original manu- 

facturer, and | split the cost with him. | think it was 

5,000 in total. | also did a lot of 288 work for him. He 

would have been the first to admit he was not too 

technical, but was a miracle worker in locating pro- 

ducts and getting people with the know-how to work 

for him. 

| saw him many times in recent years. He was still 

active and walking (very slowly) and with a stick, when 

he could be persuaded to carry one. He was though 


‘lam amazed at the professional quality of QL 
Today magazine which serves whal must now 
be a fairly small community which is seemingly 
split between original black box users and 
fhose running advanced emulators and o/s on 
modern PCs. Reading between the lines in your 
2007 issues (which is as far as I've got) the 
market was shrinking rapidly then yet both 


QL Today and Quanta are still 


quite frail. His mind was still OK, but again 
not high speed!" 
Tony has posted a gallery of recent 
photos of Bill on his website: 
htip://tfs firshman.co.uk/temp/bill/ 
John Taylor commented: 
"| first met Bill at the ZX Fairs in the 
Horticultural Hall. His stand was always a 
profusion of software, hardware and little 
bits and pieces, manna from heaven to the 
eager convert. In many respects Bill stood 
head and shoulders above the rest of us.” 
Rich Mellor described him as a "Real Gent" adding 
that it was always a pleasure to speak with him and 
John Southern as “a perfect gentleman who had time 
for everyone". 


Bills last QL show was to be Quanta’s QLis21 in 
2005, although he attended a show in Portslade a 
year later. When | asked Bill if he wanted to be 
included in the QLis21 flyer, he emailed me: 

"The QL may be 21, but | am 87 and it's time | should 
pack up, having sold over 4,000 QL, and 10,000 
Spectrums and associated bits and pieces. | have had 
a great time, made many friends and | am now 
spending more time on the fringes of politics and 
writing, so very sincere thanks to all the friends | have 
been privileged to meet over 30 years or so." 

Bill Richardson's wife, Dorothy, predeceased him in 
2005. He leaves a son and a daughter. 


gentleman” 


William Newall Richardson sadly died on 
January 3rd, 2013 aged 94. 


Most of us will have known him or purchased 
rom the company he ran after his fourth 
retirement’ in the mid 80s. 


Hé did eventually relire and lived his many 
remaining years in a magnificent sheltered 


apartment in Luton. ,| vis 
lunch very many times wit 


in 2011 with Vic, his frien 
father ,They all have som 
ical disability and used sti 


ited him there for 
Vic Gerhardi (288 


rader). .We even had a day out to Southend 


d Denise and his 
e degree of phy- 
cks. .Bill also was 


ail, walked very slowly, and with a stick if he 
ould be persuaded to use it. .\We had some 
larious slow convoys in and out of establish- 


ments. We all crammed in 
the many Southend Ros 


b 
messily. ,The pier direc 
closed as a barge had 


the end of the pier 


Bill was born on April 18, 
on the Solway Firth. .As 
puts it, slightly tongue in 
course makes him Sco 
though soon moved to Swi 


o the smallest of 
si establishments, 


locking | completely and ate ice creams, 


y opposile was 
it it the previous 


night. Sadly our 2013 trip was to take Bill to 


918 in East Riggs 
his daughter Sue 
cheek: “This of 
tish’, .His family 
nton in Lancashire, 


where he went to school. , 


did not know this, 


and it explains the lack of a Scottish accent! 
sHis retirement project was to write a book 
on the history of the Scots. ,Sadly, when | 
offered to proof read, | saw it had not got 
beyond the introduction page. Many will 
remember the tartan cloth covering his stall at 
QL shows. 


He excelled in mathematics al school and 
studied Electrical and Mechanical Engineering 
at Salford Technical College, now (of course) 
part of the University of Salford (Peel buil- 
ding). Il is a magnificent Victorian edifice remi- 
niscent of the Natural History Museum in 
London. 


loy ‘Tomy Firman 


He spent the second world war in Gosport 
and Southend doing engineering work for the 
Royal Navy. 


He married Dorothy in 1947, and his daughter 
Sue was born in 1948. .They moved to 6 
Ravensmead, Chalfont St Peter Bucks in 1952 
and Nick was born five years later. 


| remember 6 Ravensmead and Dorothy very 
well. | visited his home many times to share a 
car to QL shows, and to discuss QL and Z88 
projects. After Dorothy died in 2004, | also did 
quite a bit of work on his house and garden, 
He bought a plot of land in the 50s, built the 
road and his magnificent large detached 
house at the end. | believe he was also an 
instrumental part of the housing development 
there. 


He had a long and varied business career He 
retired three times, according to his daughter, 
because he always got bored with gardening 
and golf, and Dorothy got fed up with him 
being at home! 


Bill worked for a number of international com- 
panies including Plessey, GEC and Hughes 
Aircraft Company. .He started the first of his 
own semi-conductor distribution business’ 
which he sold in 1969 and ‘retired’ for the first 
time. His last job as an employee before his 
second ‘retirement’ was marketing director of 
Chubb. Shortly after that he re-emerged as 
the managing director of an international legal 
publishing company. Following his third ‘retire- 
ment’, he started his own software and book 
publishing company called Oxford Computer 
Publishing. (OCP) {rom an old house in Dell's 
Secondhand Car Lot in Chalfont St Peter. | 
saw those premises, and it was not quite the 
“Arthur Daly’ place his daughter likes to call it! 
.His fourth ‘retirement’ came when he closed 
OCP However it resurrected as EEC and WN 
Richardson & Co and it is this that most of us 
will remember him lor. 


Many will remember his son Nick accompa- 
nying him to QL shows, when he needed help 
with the sheer weight of his product. 


He did remarkable work for the QL and 288 
scene from the mid 80s. He had many con- 
tacts with Sinclair Research and Cambridge 
Computing (Z88) when they were active. 
When both companies ceased trading he pro- 
cured a great deal of their stock. ,This al 


lowed his colleague Felix Fonteyn (brother of 
Dame Margot) and others to assemble 
effectively new QLs in original packaging. .He 
sold thousands of these. He also arranged 
fof production of 5000 QL membranes from 
the original manufacturer .Such was his gene- 
rosity, he split the batch with me and charged 


me cost only. ,| also made a lot of product for 
him for the 288 and QL. One memorable job 
was to make {00 microdrive extension leads. 
These were with ribbon cable that could be 
twisted so that Spectrum drives faced for- 
ward. It was immensely hard sourcing the 
necessary edge connectors, which had to be 
custom made in the USA. Unfortunately he 
mislaid the finished product. | remember 
searching a number of limes in the piles of 
stock around his house. .We never found 
them. | did though find plenty of things even 
he did not realise he had, like a huge pile of 
8301 chips - much in demand then, and 
scarce. ,| often wonder whether the micro- 
drive leads emerged when he sold his home. 


[ Caimges.o 


One thing | will always be grateful to Bil for is 
the introduction to Vic Gerhardi {Rakewell Ltd) 
who trades with the 288. Vic was 
considering a flash memory card for the 288 
and Bill suggested me as the pcb designer 
and manufacturer That was in the early 90s, 
and Vic has since become not only a busi- 
ness colleague, but a very good friend. |l 
showed the flash card for the 288 to Stuart 
Honeyball (Miracle Systems) at an Eindhoven 
show, ,We travelled back together, and by the 
lime we reached England we had mapped 
out RomDisq. .So indirectly Bill was even 
responsible for RomDisa! .| don't think | ever 
told him that. 


In his latter years, after Dorothy died, | am told 
Bill took to going on cruises. .These were re- 
garded with great trepidation by his family, as 
he was always joking about getling married 
again. .His son Nick accompanied him on 
these adventures. .This was very brave of 
him, | am told, as Bill's last travelling compan- 
ion had been ‘mislaid’ in the Arctic Circle, Nick 
would hold him in check, vet any lady friends, 
and smooth over the chaos that seemed to 
follow him everywhere. .This came as a great 
surprise to me as | had never seen this side 
of his character. .From this and other things 
his family have said, he sounded a great deal 
of fun. | wish | had seen more of that side of 
him. 


He was very lucky to live a very full, active 
and healthy long life. He will be sorely missed. 


Where do | start after the obituaries? | feel | need 
to add something as well: 


| knew Bill for many many years .. and yes, he 
was a [eal Genlleman. One could rely on his 
word. Although | ‘only’ met him (many, many) 
limes al the various QL shows, | remember many 
interesting conversations with him - at the shows 
or after the shows. 


One thing | remember very well was the way he 
used to talk about the UK keeping Ihe Pound. | 
agreed and | thought in a similar way. | even bet 
on the idea that the UK will not give up ifs 
currency, like we in Germany were forced to. 


Dy fochen Marz 


| remember that he gave me flyers and stickers, 
saying ‘Keep the pound - save democracy.’ How 
right he was. We all seem to lose democracy, but 
| feel that history books will name the EURO to 
be the worst mistake. 


Although Bill was more into QL hardware and 
even more into 288 producls, il was always great 
talking to him. Yes, he will be missed. 


.. a short break... 


ext the answer lo the question which was 
printed on the front cover of issue 2. The 
"When?" about ihe Hamburg QL meeting. That's 
something | don't really know. Not this year, that's 
or sure now. 


When | initially asked the newsgroup in Novem- 
ber about a date for the planned meeting in 
Hamburg, | got some replies. Not many, but some. 
Then, QL Today was shipped in December and | 
got exactly ONE additional reply ... that's all. | was 
hoping for a few more replies, but until today, end 
of February, that was all | got. Disappointing, but 
reality. 

| spoke to Rainer Wolkwitz, who offered the 
rooms for the venue, and we both thought we 
might end up sitling there together hoping for 
one or two visitors to arrive. 


Hamburg is always worth a visit, but my wife and 
| feel it is not feasible to drive to Hamburg, stay 
two nights, spend the day in between in the 
room, hoping for a visitor to arrive, and drive 
home. Not the way we currently feel, health-wise. 
We have cul down considerably on travelling ... 
we both feel too tired and exhausted. 


Rainer said that the rooms will be available in 
2014, 2015 and probably the following 4 years or 
so. Which means, a meeting in Hamburg may not 
necessarily be completely cancelled, but moved 
forward to next year .. who knows. 


Maybe it needs more time than 5 or 6 months 
advance. Maybe travelling is something we all tr 
to avoid - maybe we all are getting older an 
travelling is just too expensive nowadays. Mayb 
there is no interest in getting together, as there 
not much news nowadays. Feedback is most 
welcome! 


The next change is related to the next issue of 
QL Today. We explained in the last issue that the 
posiage in Germany roughly tripled as of 
January this year, because Deutsche Post do not 
offer the services | used to use anymore. This 
means, that QL Today cannot be offered at the 
current price. As it would be a considerable 
increase, Geolf and myself discussed the 
siluation and we both thought, time has come to 
decide that QL Today in its current form will end. 


| remember that many years ago, ! spoke to Roy 
Wood and we thought: well, if the readerships 
falls under 400, we stop. It did, but we continued 
(OK, easy for him to say thal as | did ihe main 
work}, Same for 300. We continued. Same with 
Geoff .. the readership is under 200 for some 
years and we still continued. 


However, there are things we cannol change: the 


anoa<x< 5 


costs. Printing costs have gone up. shipping, so 
the price-per-issue is too high now. 

We would like to end the volume (and QL Today} 
in a way that the last issue will come in paper and 
electronic form. Producing CDs/DVDs takes a 
long time .. and as the summer time has always 
been quiet in the past, Geoff and | thought that 
we will skip summer this time and deliver the final 
issue 4 of QL Today in September. Both on paper 
and on digital media. 


We have stretched Ihe deadline slightly .. but 
remember, that once the paper issue is done, it 
needs to be converted and then the CD has to 
be produced. 


If you feel you would like to send us a comment, 
letter article, to be printed in the next and last 
issue, please co so. | don't mind getting over the 
32 pages-limit again - as far as | am aware, we 
did this in every issue since it had been an- 
nounced .. well, better for the readers than 
having a much thinner issue, which would have 
led to a much earlier end of QL Today. 


If you now ask, if this really is the end of QL 
Today, then my answer will be a definitive ‘Yes’. 
Do | want to see somebody to continue? Not 
really, to be honest. If somebody wants to start 
something ‘fresh’ - up to him. During these 17 
years, | have tried very very hard to be as 
reliable as possible and deliver what was paid for. 
relied on the help of others, all the authors, of 
course, Stuart, Roy, Dilwyn, Geoff, Bruce etc. - and 
we all did very well. | do not wanl to see QL 
Today connected to something negative, ending 
ike IQLR’, for example, so let's end it. 


am feeling rather sad while | write these lines - 
QL Today has been a major part of my life... after 
all, | produced it for 17 years and especially in the 
early years, we had six Issues per year - both 
English and German! How did | manage it these 
days, time-wise? | don't know. 


Enough changes and bad news, you will think. 
Yes, | think so too. That's enough. My website wil 
remain, the products will still be offered (for al 
east as long as my old EPSON laserprinter wil 
survice). Maybe | will find a bit more time afler QL 
Today to convert documents from text87 EPSO! 
GQ mode to PDF update some products, fix 
some bugs. Would be great. | do miss program 
ming in assembler Will probably take some time 
lo get into it, bul it has always been a pleasure. 
So whatever happens it will hopefully be 
reported in the Quanta magazine, on my website 
SMSQ.J-M-S.com and | will report news, updales 
and changes to the QL Newsgroup, of course. 
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| SMSQmulator > THE FIRST SIEPS 


| have a bone to pick with Wolfgang Lenerz. Last 
May he announced he was writing an SMSQ/E 
emulator for Java. He released SMSQmulator 
towards the end of January on the day before | 
was due to be away from home for a couple of 
days. | arrived back, weary from two nights sleep- 
ing on a boat, and having coped with severe 
public transport disruption through ice and snow 
in two lands, to discover no fewer than 85 emails 
in my inbox. Almost all had the subject line 
“SMSQmulator’. Clearly Wolfgang had aroused 
the QL community from its winter hibernation. 


Until now there has been very little interes! in 
Java among the QL-ers. However it is a program- 
ming language used in many devices and an 
emulator for Java raises the possibility of a QL 
platform for mobile devices. 


You will almost certainly have Java installed on 
your PC, but, if not, you can download a copy 
from: 


www,java.com 
The emulator ilself can be downloaded from: 
wwwwlenerz.com/SMSQmulator 


(Wolfgang warns that this address is case 
dependent) 


There are two versions of the emulator one for 
Java 6 and the other for Java 7. Wolfgang wriles 
that ‘both versions are funclionally identical. 
However, | have noliced that under Java 6, some 
Linux machines will NOT play sounds, where they 
will under Java 7’. 


If you are uncertain which Java version is on your 
machine you can always upgrade to Java 7 from 
the Java websile. lt was quicker to do this on my 
laptop than investigate which version of Java was 
already installed. 


by Geatti Wicks 


The emulator comes in a 1.56 Mb zipped file con- 
taining the emulator itself, SMSQ/E, a WIN file, a 
subdirectory called ‘lib’ and two manuals, one by 
Wolfgang and the other by Tim Swenson, who did 
much of the beta testing. Before unzipping the file 
itis useful to have a folder called SMSQmulator. 


Wolfgang's manual is 31 pages long and Tim's 23 
pages. Both are pdf files and both are legible on 
my e-reader Wolfgang starts his manual with the 
words: 


"Please read this ENTIRELY before you do 
anything else." 


| wonder how many people did that. He does 
warn, however, that sections | to VI are essential, 
and it would be difficult to use the program 
without referring to them. 


Loading SMSQmulator is usually very simple and 
is jus! a matter of clicking on the SMSQmulatorjar 
file. It usually loads quickly and, as supplied, after 
a brief sighting of the familiar white and red 
screens, loads a menu for 3 QL games, 1 SMSQ/E 
game and Xchange. The default screen is the 
standard QL 512 x 256. 


(es SMSQmiutatos _— 


rie config ? 


lt is worthwhile to 
spend some time ex- 
ploring this screen to 
familiarise yourself 
with this program be- 
fore moving onto 
something more am 
bitious. 


Initially you — should 
look at ihe first three 
menu items only, be- 
cause ihe other two 


require configuration changes. The three items are 
‘old fashioned” QL games. 


When you have finished playing with these it is 
time lo move onto Xchange, which is the Marcel 
Kilgus version using a 512 x 512 screen. Click on 
‘Config’ at the top of the screen and a pop-up 
menu appears. 


{ Language/Sprache/Lenguaje/Langue } 


Set dirs for NFA drives © 
NFA file name -changes b 
NFA USE name 


Set dirs for SFA drives 
SF4 file name changes bd 
SFA USE name 


Set files for WIN drives 
WIN USE name 


Set files for FLP drives 
FLP USE name 


Set screen size 


Set screen colours/mode 


Set memory size 
I Monitor visible 
If Fast mode 


Blinking cursor pause: 


Tire correction 
Double the window size 


Warnings 
Configuration Menu 


Most of the items on this menu will be meaning- 
less as we still have a lot to learn about the pro- 
gram. You should click on ‘sel screen size” and 
change this to 512 x 512. Any configuration chan- 
ges you make are saved and will be the configu- 
ration the next time you load the program. On oc- 
casions you may have to click reset or even exit 
the program and restart it to make the configura- 
tion changes operative. 


You can now load and experiment with Xchange. 
Try, for example, some simple word processing or 
a simple Easel graphic. You cannot load or save 
files al this stage because we still have to learn 
how SMSQmulator handles devices. 


The next stage is to look af the QJewels game. 
So far all the programs we have looked al use 
original QL colours. QJewels uses high colour 
mode and we have to reconfigure SMSQmulator 
lo play it. Go into the configuration menu and 
amend “Sel screen colours/mode’ to 16 bit 


colours. To make the high colour mode active you 
have to end SMSQmulator and restart i! afresh. 
Once you have made the change !o high colour it 


is worthwhile to keep SMSQmulator in that mode. 


When you have finished looking at Wolfgang's 
menu program it is time to start planning your 
own program use. Before you can do this you 
must first master SMSQmulator's device handling. 
There are four different device types, WIN; NFA 
(Native File Access): SFA (SMSQ/E File Access); 
and FLP 


If you are unfamiliar with this 1erminology, don't 
worry, because if you are a QPC2 or other 
SMSQ/E user you will already be familiar with the 
concepts. In QPC2 terms examples of WIN would 
be winl_ and win2_ ; of NFA dosi_ and dos2_ ; 
and SFA flpi_ and flp2_. 


The difference between an NFA and an SFA 
device is that NFA devices cannot save all QL 
files correctly. For example, you can save text, 
basic and compressed files, but not _exe and 
similar files. 


It was probably a little unwise for me to make a 
comparison between QPC2 and SMSQmulator 
because there are large differences over the 
handling of SFA devices. 


This is best explained by my own experience 
when testing devices on SMSQmulator. 


For the WIN device | used the same QXLWIN that 
| use for QPC2. SMSQmulator booted success- 
fully from this device and most of the programs 
on it ran under SMSQmulator. 


Cancel | 


WIN Drive Menu 


For the NFA device | used a USB memory stick 
almost permanently atlached to my PC. | use it in 
a similar way that | used to use floppy disks, thal 
is for lemporary and back up storage of a wide 
variety of files. QPC2 and SMSQmulator both 
access this device in the same way. The device 
has a small number of SuperBasic programs on it 
and | was able to run them directly from this 
device. 


SMSQmulalor SFA devices are, however, different 
from QPC2 SFA devices. If | pul a floppy disk in 
my PC, QPC2 would be able to read and write to 
it whether it was a QL or a PC formatted disk, 
although some QL files would be corrupted on 
(he PC formatted disk. SMSQmulator would read 
and write to a PC formatted disk, but would not 
recognise a QL formatted disk at all. In SMSQmu- 
lator SFA devices are not the physical device as 
such, but the way in which files are stored on that 
device. 


I set up my SFA device on a small memory card 
fitted into a card slot on one of my printers. | 
copied a file, postcodes.exe, from wini_ to the 
device, slai_. | could then run postcodes_exe 
directly from the memory card, if | tried to run 
postcodes_exe directly from ihe memory card on 
QPC2 it would not work, because QPC2 would 
not recognise the file type. Equally if | had 
transferred postcodes_exe from QPC2 it would 
not run in either QPC2 or SMSQmulator. 


The biggest difference between QPC2 and 
SMSQmulator is in the use of flp. QPC2 looks al 
the physical disk, but SMSOQmulator does not. The 
latter has to look at an image of a disk and that 
image does noi have to be on a lloppy. There are 
programs, such as Rawread, that allow you to 
make an image of a disk on a PC device, 


As it happened | had an flp image on my working 
USB memory stick. By pointing SMSQmulator to 
thal, | could view the directory and load the bool 
file. (In this case | would not have been able to run 
the program as it is an old game only runnable on 
native QL hardware.) 


Please note that you cannot write to an 
SMSQmulator flp device. You can only read from it. 


| would strongly advise you to carefully read the 
sections of the manual dealing with devices - lll, IV 
and V - because there are a lot of nuances and 
advice on their use. 


if we return to the configuration menu, a lot of the 
items that were meaningless when we first looked 
al it, now begin to make sense. We can also see 
how to attach a device to SMSQmulator. All you 


‘do is to click on the menu item of the type of 


device and then a menu comes up showing the 
list of devices. You can, if you wish, click on the 
dots on the right of the device number to 
navigate through to the directory, but | found this 
a slow process. tt was quicker and easier just to 
type the directory in. 


You now know enough to make your own use of 
SMSQmulator, but how compatible will it be with 
programs you use? 


The first 
thing to 
stress is that 
SMSQmulator 
is not a QL 
emulator and 
iS nol inten- 
ded to be a 
QL emulator 
lt is an 
SMSQ/E 
emulator and 
thus will not 
be compaii- 
ble with pro- 
grams, such 
as old 
games, that 
will not run 
on other 
SMSQ/E sys- 
lems. 


# Other — than 
that it is high- 
ly compatible. 
When | at- 


Thu 7 Feb 16121 


Directory and boot program from flp image 


tached = my 


working WIN device to SMSQmulator, it ran the 
boot program | use for QPC2 loading, among 
other things, QPAC2 and the QTYP extensions. 
Practically all programs on the WIN file ran without 
problems including, | am pleased to say, the entire 
Just Words! range. 


Very few incompalibllities have been reporied and 
the main problems have been with some graphics 
programs and ProWesS, However Wolfgang has 
quickly and efficiently followed up any problems 
and the very latest version now loads LineDesign. 
| am still having difficulties with the graphics pro- 
grams, but this may be a problem with my system 
because others are not reporting the same 
problems. 


Another question is the speed of SMSQmulator 
The only thing that can be definitely said is that it 
is faster than the black box, but much slower than 
QPC2, Wolfgang suggests that SMSQmulator 
should be about one tenth of the speed of QPC2, 
but users have reported wide variations. To give 
you an example SMSQmulator is one tenth of the 
speed of QPC2 on my laptop, but only one seven- 
teenth on my desk top. 


The reason for this is a little uncertain. Some have 
suggested speed problems are inherent in Java, 


but others have said these problems were only 
characteristic of early Java versions. Another 
suggestion is that the specific hardware, single 
core or multicore processor, of a PC could have 
an effect. (My laptop is dual core, but my 10 year 
old desktop is single core) SMSQmulator does 
seem to hog processor time and is probably 
easier to run on a multicore machine. Wolfgang 
says that Java only uses one core on a multicore 
processor, which means that it is unlikely to affect 
the performance of other programs. 


Tim Swenson commented: 


‘On all systems that | have run SMSQmulator, it 
really sucks up the CPU lime. There is an option 
to have it take up less CPU time when the 
cursor is blinking. 
Even when running 100% CPU, I've found the 
other applications are not greatly impacted and 
are fairly responsive. | just noticed my fan kick 
in a lot more offen.” 


In summary, SMSQmulator is a remarkable piece 
of soltware. Given its complexity the number of 
bugs reported has been very small. If nothing else 
Wolfgang Lenerz has given the QL community 
not just a new product by also a welcome boost 
to our morale. 


Norman 


fro discussions with George & 


ly George Gwilt and Norman Dunloar 


Norman's response to George's Letter to QL Today re Norman Dunbar's Article on Assembler - Part 
31, Part 3, Norman's IND] answers to George's [GG] comments on Assembler - Part 32. Comments 


inserted by the Editor are marked [ED]. 


{GG] In Part 3 of Part 31 Norman gives the code for the four utililies missing from his program so far. 


As usual! have a few, mainly minor, comments. 


{ND} Minor? | like minor, it means | haven'l screwed up too badly! ;-) 


{GG] 1. in both the routines cp_siring and ap_string on pages 25 and 26 which deal with strings there 
is a branch to the exit if the string length is zero. In fact that branch ts not needed since in both 
cases the program will exit via the later dbf instruction and no copying will take place. 


{ND} This | agree with. And yes, it does wasle the odd couple of clock cycles, however, | do try |o be 
explicit in my coding - both at work and at play. Hence the habit of checking for stuff! don't want 
and baling out early when il is found. However, il is a point to bear in mind when every byte is 


sacred. Like back in my IKb ZX-81 days! 


{GG] 2a. In iw_print Ihe instruction setling D3 lo ~1 after the tabel iwp_prnt is only needed if a branch 
to iwp_prntis in fact made from anywhere. | cannot delect any such branch. 


{ND} Yes, D3 need nol be set al thal point as it is preserved by the previous trap #3 to clear the window. 


[GG] 2b. Also, | suggest thal the testing of DO should appear before, not after iwp_exit. The reason is 
that if the branch to iwp_exil is taken then at that point DO contains the non~zero item #io_sstrg and 
not the error return from the corresponding trap #3. 


[ND] This is a bug in my program library. | shall wrile up a correction in the next article. Thanks 
George. My suggestion would be lo move the instruction moveq #io_sstrg,d0 from its current location 
at iwp_prnt and place it after the instruction bea.s iwp_exit. That way, DO is zero when a return from 
CLS is made and if there is nothing to print, we exit with DO correctly set to zero and the flags set 
accordingly. 


[GG] 3a. In iw_input | suggest that the four lines starting 
cmpi.w #$0a,d1 
near the top of page 24 should be deleted ... 


{ND} Yes. This code is not necessary. It was put there as a “bug fix’ which George and | have 
discussed by email. The bug in question is in the documentation and it states that error returns would 
have negate, zero or positive values depending on what caused the end of the edit. 

When I read the docs, | assumed, incorrectly, that this meant DO would be set as above, however as 
George pointed out to me, it never mentions DO and simply says that the Condition Codes would be 
Set. 
Because | assumed a bug, | wrofe my library code to return a correct (ahem!) value in DO which was 
whal | though that the docs were telling me. They were not, it was my own inability to read English 
that was faulty. 
As George says, those 4 lines can be removed. However, doing so will require changes elsewhere in 
the code. If those 4 lines are left in, then the comments in the header for IW_PRINT will be correct - 
and DO will be sel as advised. 


(GG) 3b. ... as well as 
tst.1 do 

which appears three instructions later My reason is this, All uses of iw_input in Lib Gen are in the three 
routines sym_hit. lib_hit and bin_hit. These are followed by a branch, if error to the exit and later by a 
call to iw_print. If the branch to the exit is taken it is because there is an error with the negative code 
being in DO. If there is no error then iw_print will almost immediately set DO as a result of the call to 
wm_swinl. This means that there is no need to set DO and test it in iw_input since this will have no 
elfect. 


IND] The above is valid, in the current context of LibGen at least. | use this code in other programs. 
What you are seeing here is not the full library either, but a slightly reduced version to avoid having to 
print (or type in) code that is never called by this utility. 


[GG] 4. In both lib_hit and bin_hit the routine ends with 


bsr iw_print 
rts 

In both cases this can be replaced by the single instruction 
bra iw_print 


Of course in that case the branches to bf_exil and If_exit will have nowhere to go. These branches 
can be replaced, in both cases, by 
bra sh_exit 


[ND].| try to keep my sub-roulines/liprary stuff as ‘one way in, one way out’ Sometimes | fail in this, 
but usually, it’s only possible to exil a library or subroutine by a single RTS. At my age, trying to keep 
track of multiple entries and exits is too much for my brain! 


[GG] 5a. In li_avail on page 27 there should be a plus sign, not an underscore after ws_lilem 


{ND} Given that I've been executing this code quite happily, and so far, all is working as expected, | 
was confused by this. Il appears to be a transcription error - which confuses me even more, as | 
import my code directly into the article! It is indeed supposed to be a plus sign. t have no idea where 
the underscore came from. 

To be clear, it should look like this: 

li_avail move.1 #$01011101, ws_litem+1li_libfile(a1) 


[GG] 5b. Also the final two instructions in this routine could be replaced by 
jmp wm_ldraw(a2) 


{NDI They could indeed. 


(GG] 6. | must now apologise for returning once again to the “error returns’ from wm_ename. A close 
examination of the source code shows thal, as is absolulely normal, the register DO is either set to 
zero, showing no error or is set to the negative error code. If there is no error, register DIW wil 
contain the terminating character, which must be one of ENTER, ESC, UP and DOWN. 

What is also completely standard is that the condition codes are set to N if there is an error What is 
unusual in this vector is that if there is no error the condition codes are set as the result of comparing 
DIW with the code for ENTER ($0A). In the case of normal vectors you can branch on error using BMI 
or BNE. In this case you can't use BNE. The simplest way of alerting programmers to this fact is fo tell 
them that condition code »0 can occur as well as ZERO when there is no error 

There is therefore no bug in wm_ename as Norman suggests on page 22. 


Perhaps the statement in the manual, which is 
“Error returns 
Any {/0 sub system errors 
0 if terminating character not Nb" 


is ambiguously succinct and might lead one to think that DO as well as the condition codes is set 
greater than 0 for a terminating character other than ENTER, However, a later senlence in the manual 
reads 
‘The condition codes will be set fo -ve for an !O error zero for ENTER or positive for other 
terminator 


[ND] Yes, George and | discussed this by email a while back. The splitting of my article into two 
separate parts gave us plenty of lime to discuss the ‘bug’ and we agreed in the end that it was me 
who was wrong and the manual was correct. 
As | explained above, my assumption that all the Error Returns in the QDOS/QPTR docs means DO 
was incorrect and caused me the problems. | should learn to read and understand English | think. The 
manual talks of the Condition Codes and doesn't mention DO. | read that as meaning DO rather than 
the condition codes. 
As mentioned above, the next (exciting) instalment will have a correction noted. 


{GG] 7. It is a very minor point bul | wonder why Norman uses BLT instead of BMI to branch on an 
error. The instruction BLT branches if either one or the other but not both, of N and V is set. BMI 
branches if N is sel. Thus, if both N and V are set BMI will correctly cause a branch but BLT will not. It is 
unlikely, bul nevertheless remotely possible, that both N and V could be set in a program. 
The instructions 

moveq #-1,d0 

and #2,cer 
would do il. 


IND] Both BMI and BLT are signed comparisons, as George probably knows better than me. | often 
wonder why we need both of these though! BLT is used after a call to IW_INPUT which, as we know, 


in its current state, is handling returns by setting DO to negative, zero or positive and then setling the 
flags accordingly. 

| admit, 've had to check my Motorola manual to check out the difference and to be honest, ! suspect 
that | should be using BMI as it does indeed only check the N flag. BLT will lake the branch if (N=1 and 
V=0) or (N=O and V=1}, so could take a branch on overflow only ~ which is unlikely in this situation, but 
in other programs, could be the cause of a hard to find bug. 

Interestingly, Andy Pennell, in his book Assembly Language Programming, doesn't mention BLT on 
page 26 but does, later on in the book, on page 30 ~ but without giving a good explanation for their 
purpose, Hmmmm, perhaps the Motorola CPU has too many branching tests! 


{GG] Finally | look forward eagerly to the next instalment. 


[ND] There should be one somewhere else in this edition! 


{ED] Yes - it is. Quite a long discussion this time considering the initial "minor"; -) 


Directories 


David! Denlvam 


What is a directory? 


Think of your computer as a filing cabinet with several drawers. Each drawer is one of your drives. 
Within each drawer you can have several folders each holding groups of files. The term ‘directory’ is 
synonymous with the term ‘folder’ as far as we are concerned. 


Wilhin each drive you can have several folders each holding groups of files. For example, one could 
contain all your letters, another could hold all your spreadsheets, while another could hold your 
SuperBASIC programs. 


Each folder or direclory can contain further folders. For example, the one containing your SuperBASIC 
programs can be further split into Games, Ulilities, Music programs and so on. Directories within 
directories like this are referred to as Sub-Directories. 


On an original QL, all files were just lumped together without any real form of grouping. This wasn't 
too bad when all we had was microdrive cartridges holding about 100 kilobytes each. Then we got 
floppy disks which could potentially hold dozens if not hundreds of small files. As we filled the disks up, 
a DIR command could give a very long list of files making it harder and harder to find the file we want. 
Imagine a disk containing over a hundred files ~ such long lists of files quickly become unmanageable! 


When hard disk systems came along for QLs things got even worse. Now you could probably save 
hundreds if not thousands of files - something had to change. 


And change it did. Add-ons like the Miracle Systems hard disc drive introduced us to Level 2 Filing 
Systems for the QL. The term Level 2 simply means the next level of QL filing systems - directories. 
The disc could be split into separale folders allowing you to group files together to make file 
management a lot easier Such directories were also called ‘hard directories’. The name came about 
since the original ‘soft directories’ were just liles wilh a prefix added lo the name! 


How Do | Know Which Systems Handle Directories? 


First you have to know that your compuler or emulator is able to handle these Level 2 Directories. If it 
has a MAKE_DIR command built in, chances are you can use directories. If the manual doesn’ tell you, 
check this with the EXTRAS command - the list should contain the MAKE_DIR command, or in some 
cases an equivalent function called FMAKE_DIR. 


The situation is perhaps not as simple as we might like though. 
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An original Tump Card doesn't support level 2 directories or ‘hard’ directories, while laler versions 
supplied by Qubbesoft had an updated ROM allowing use of directories! The lable below lists some 
types of QL systems and whether or noi they can support directories. The list is far from complete - if 
it's not in the list | just don't know! 


System Type Level 2 Directories? 

Unexpanded QL No 

Microdrives No 

QL and Trump Card Later versions only 

QL and Gold Card/Super Gold Card Yes 

Other floppy disk systems Mostly no, although updated Level 2 ROM 
eould be fitted to some disk interfaces 

Aurora Depends on disk card interface fitted 

Thor Some versions - yes, although non-standard 

040/960 Yes 

Qubide Yes 

Miracle Systems Hard Disk Yes 

QLay and QL2K No 

Qemulator Registered version only 

QPC Yes 

SMSQmulater Yes 


Here is a simple little test routine which will just test for the presence of the MAKE_DIR or FMAKE_DIR 
extensions on your system. It needs a ramdisc for the temporary file. 


1000 DEFine PROCedure Level2_Test 
1010 LOCal testing, extension$ 

1020 OPEN_NEW #3,ram1_tmp 

1030 EXTRAS #3 

1040 CLOSE #3 

1050 OPEN_IN #3, ram1_tmp 

1060 REPeat testing 

1070 IF EOF(#3)=1 THEN EXIT testing 


1080 NPUT #3,extension$ 

1090 IF extension$ == 'MAKE DIR! THEN 
1100 PRINT'MAKE_DIR command present! 
1110 END IF 

1120 F extension$ == 'FMAKE_DIR' THEN 
1130 PRINT'FMAKE_DIR function present’ 


1140 END IF 

1150 END REPeat testing 
1160 CLOSE #3 

1170 DELETE rami_tmp 

1180 END DEFine Level2_Test 


Just enter the command LEVEL2..TEST and it will look through the list of extensions for MAKE_DIR or 
FMAKE_DIR, printing the name of whichever it encounters in the list, 


If you prefer a function lo lest if there's MAKE_DIR or FMAKE_DIR on the system, try this: PRINT 
IsitLevel2 will return 1 if here is a MAKE_DIR or FMAKE_DIR extension. 


2000 DEFine FuNetion IsItLevel2 
2010 LOCal testing, extension$ 
2020 OPEN_NEW #3,ram1_tmp 
2030 EXTRAS #3 

2040 CLOSE #3 


2050 OPEN_IN #3,ram1_tmp 

2060 lev2=0 

2070 REPeat testing 

2080 IF EOF(#3)=1 THEN EXIT testing 
2090 INPUT #3,extension$ 


2100 IF extension$ == 'MAKE_DIR'. OR extension$ == 'FMAKE_DIR' THEN 
2110 lev2 = 1 : EXIT testing 
2120 END IF 


2130 END REPeat testing 
2140 CLOSE 43 

2150 DELETE rami_tmp 
2160 RETurn lev2 

2170 END DEFine IsItLevel2 


Creating Directories 

Directories are created with the MAKE_DIR command like this: 

MAKE_DIR drive_directory_ 

So to make a directory on FLP1_. to hold BASIC programs we use: 

MAKE_DIR FLP1_BASIC_ 

If the system has the FMAKE_DIR function, it makes it easier to cope with error trapping: 
LET errorcode=FMAKE_DIR( FLP1_BASIC_) 


FMAKE_DIR will return a negative error code if something went wrong. This error code may be one of 
the following: 


-7 = Not Found (drive not available} 

-8 = Already Exists (directory of that name exists already) 
-9 = In Use (directory of that name exists already) 

~15 = Bad Parameter (cannot handle directories on this drive) 


Some Rules 
A few rules to note: 


1, The direclory name should end with an underscore character, although many systems will add this 
automatically if it is missing. 

2. The name of the drive and directory does no! have to be in quotes unless it contains a non-ascii 
character such as a full stop or space, The name can always be in quotes if you prefer, or may 
also be a string variable, e.g. LET d$="Flp1_Games_.”:MAKE_DIR d$ 


3. Most systems will let you include an underscore within the directory name, but this is poor practice. 
An underscore may mean the end of a directory name, so on some systems it may Cause a mild 
confusion as to where the directory name ends. | lend to steer clear of underscore characlers 
within a directory name. It makes life easier if you just use letlers and numbers. 
ost systems will allow spaces if you want lo make long name more readable, but of course the 
name has to be in quotes. | find it best to avoid spaces and other non-alphanumeric characters. 
4, Name lengths. The sum length of both the directory name and a file name may not exceed 36 
characters. So il is best to keep directory names short and meaningful, especially when using 
sub-directories within olher directories, remembering ihat the underscore characlers also coun! 
lowards the maximum length of 36. 
5. Like QL filenames. directory names are usually case insensitive - it doesn’! matter if you use 
upper case, lower case or a mix. The only exception is some emulalors which are subject to the 
case sensitivity of the file system on which they run. Linux, for example. 


Saving Files To Directories 


To save a file to a directory, we just include the directory name before the filename. We can save a 
BASIC program called mygame_bas into a directory called BASIC on drive WINI_ 


SAVE wini_Basic_MyGame_bas 

of, of course 

SAVE "wini Basic_MyGame_bas" 

Copying a file from floppy disc to hard disc is just as simple: 
COPY Flp1_MyGame_bas TO wini_Basic_MyGame_bas 


If your system has the WCOPY command, you can use this fo bulk copy files, e.g. to copy all files from 
Flpi_ to Wint_Basic_ just use: 


WCOPY Flpi_ TO Winl_Basic_ 
Equally, if you wanted to copy files back from a hard disc directory back to a floppy disc: 
WCOPY Win1_Basic_ TO FLP1_ 


What the command does is try to work out the differences between where the files are stored and 
copied to and change the full filename accordingly. 


WCOPY can also use a simple form of wild card name, so that only files matching that wild card are 
copied. Supposing we have a disk full of all sorts of files and we wished to copy just the Quill 
documents to a directory called Winl_Quill and just the Abacus spreadsheets to Wini_Abacus_ 


WCOPY Flpi__doc TO Wini_Quill__doe 
WCOPY Flpi__aba TO Wini_Abacus__doc 


The wildcard is the extension - anything ending wilh doc or _aba in these examples. 


DIR List 


When you DIR a disc containing directories, the name of a directory is shown on most systems by 
having the ‘-»" characters after a name. 


DIR WIN1_ 

might give 

WIN1 QDOS 35840/40960 sectors 
boot 

Basic -> 

Games -> 

Xchange —> 


In this example, | have a boot program written in Superbasic plus three directories called Basic, Games 
and Xchange. Note how the directories have -> aller the name, and how the last ‘_’ is not normally 
shown. 


It is quite normal not fo put important system files such as a boot program nol into any directory, This 
is called putting a file in (he ‘root direclory' or ‘base directory’. You may also come across some 
programs which may not work correctly from a directory, so these can be put in a root directory if 
required as long as you remember to keep the number ol files down to reduce clutter. 


Sub-Directories 


If we want to create sub-directories wilhin an exisling directory, that’s quite easy. Just work out whal 
you want and make sure the main directory exists first. in an example, [m going lo create a directory 
to hold a copy of Xchange, and within thal four subdirectories to hold Quill, Abacus, Easel and Archive 
files. 


First, | create the main directory called Xchange: 
MAKE_DIR Wini_Xchange_ 


Next, | create the four sub-directories to go inside the Xchange directory, simply by adding the names 
of the sub-directories to the name of the main one. Ill call these sub-directories Quill, Abacus_, 
Archive. and Easel_ 


MAKE_DIR Win1l Xchange _Abacus_ 
MAKE_DIR Winl Xchange_Archive_ 
MAKE_DIR Win1_Xchange_Easel_ 
MAKE_DIR Win1_Xchange_Quill_ 


| happened to put those in alphabetical order, but there is no real need to do this unless you want 
them to appear in alphabetical order in a DIR list. 


if | now do a DIR of Wint_ the list is still shown the same as the first example above. But if |now do a 
DIR of Wint_Xchange_ | see the new sub-directories: 


WIN1 QDOS 
35840/40960 sectors 
Xchange_Abacus ~> 
Xchange_Archive -» 
Xchange_Easel -) 
Xchange_Quill —> 


So you can see that if you use DIR fo list the content of a directory, it shows what's in thal directory 
and nol anything in the main directory before it. This brings us to their hierarchy ~ the first directory is 
referred to as the ‘top level’ directory. 


When you have directories within directories, you can think of the whole structure as a ‘tree’, with 
various branches leading away from the root or top level. You can draw a diagram a bit like a family 
tree (an upside down tree) like this. This will help us envisage what a directory structure is like when it 
comes fo ‘navigation’, 


WIN1_ 
| | 
Basic. Xchange_ Games 
Abacus_ Archive_ Easel_ Quill_ 
Sub-directories within other directories are sometimes referred to as ‘nested directories’. 


Deleting Directories 


From time to time we may need to delele a directory, either because we have finished using it, or we 
have realised we made a typing mistake and misnamed it. Suppose I'd intended to creale a directory 
called Winl_Toys_ and accidentally typed MAKE_DIR Win1_Tyos_. The direclory can be deleted with a 
simple DELETE command as long as you take care to lype the name correctly to avoid accidentally 
deleting a similarly named directory! 


DELETE Wini_Tyos_ 


However, you cannol normally delele a directory name if it already conlains some files. You would 
need to delete those files first. So if | had a directory named Winl_Texis_ which contained three plain 
lexi files, I'd need to delele all three of those files before | could delete the directory called 


Winl_Texts_. A quick bul potentially dangerous way of deleting them would be to use the WDEL 
{Wildcard Delete} command to delete all its files first: 


WDEL Wini_Texts_ 
then DELETE Wint_ Texts_. 


If you have sub-directories within a directory, you will need to delete the conlent of the deepest 
directories first, then delete the sub-directory names, then delete all the files in the parent or higher 
directory and work your way backward until you reach the one you want lo remove. Taking 
Winl_Xchange_ in the example tree above, in order lo remove Wini_Xchange_ you'd need to delete 
the content of all four sub-directories first, then delete all four sub-directories, then delete any 
remaining files in Winl_Xchange_ before finally removing Wint_Xchange-. It is a bit tedious with a lot 
to type in, but perhaps that’s no bad thing as it forces you to do it step by step to avoid accidentally 
deleting everything! 
The sequence of BASIC commands you would need to delete Wini_Xchange_ above would be: 
1. Remove sub-directory content: 


WDEL Wini_Xchange_Abacus_ 
WDEL Winl_Xchange_Archive_ 
WDEL Wini_Xchange_Easel_ 
WDEL Wini_Xchange_Quill_ 


2. Delete sub-directories: 


DELETE Wini_Xchange_Abacus_ 
DELETE Winl_Xchange_Archive_ 
DELETE Winl_Xchange_Fasel_ 
DELETE Wini_Xchange_Quill_ 


3. Delete any other files left in Winl_Xchange_: 
WDEL WiniXchange_ 

4. Finally delete Wini_Xchange_ ilself: 

DELETE Wini_Xchange_ 


Default Directories 


it can be a bit tedious typing in very long drive and directory names, so Toolkit 2 added commands to 
set default directories. There are three of them in all - one called PROG_USE to set default directories 
for programs you can execute (e.g. Xchange or QL Quill), DATA_USE for ordinary data files and BASIC 
programs and DEST_USE for the default destinalion when copying files. q 


1. PROG_USE drive_directory_ 


Suppose you keep your executable programs in a directory called PROGS_ on Wint_. You can set 
PROG_USE Wini_Progs_ to make EXEC and EX commands start the programs from there by default 
without having to add a drive and directory, Lel us compare two EX commands: 


EX Wind_Games_MyGame_bin — this starts the game called MyGame_bin from Wini_Games.. in other 
words you specified a drive and directory called Wint_Games_ 


EXUtility_Task ~ here you have specified no drive and directory, so il looks on the one specified in 
the last PROG_USE statement automatically (called the Program Default Directory), in this case 
Winl_Progs_. Saves a bit of typing when you have grouped all of your programs in the same place. 


2. DATA.USE drive_directory_ 


Suppose you keep your BASIC programs in Winl_Basic_. ANer DATA_USE Winl_Basic_ the computer 
will look for a Basic program or indeed any data file in this directory unless you explicitly stale where: 


LOAD Win1_Xchange_MyBasicProg_bas ~ {his one specifies a drive and directory, so it will look for the 
file there. 


LOAD MyBasicProg_bas - this doesn't specify a drive or directory, so it checks the DATA_USE default 
value. In other words, it realises you didn't specify anything, looks up the default (called the Data 
Default Directory) which was WinL_Basic_ so ends up loading the file from there. 


Given that data files are more likely to be spread across many directories, this is less useful in this 
particular context, but another use is for the DIR command. If you had set DATA_USE WINI_ then enter 
the command DIR with no drive name, it looks up the Data Default Directory value {Winl_) and tries to 
do a DIR of that, in this case like a DIR WINL_. 


3. DEST_USE drive_directory_ 
Sets the default destination directory when files are being copied, moved or renamed, usually when 
these commands which would otherwise be used with two names this provides the second or 
destination name. If the destination name does not end with a ‘_' it usually means it’s a non-directory 
device, such as a serial port or parallel printer port. 


This can be useful. Set DEST_USE ‘PAR’ on a system with a parallel printer port and this can be useful 
for copying files to a printer, using either COPY or SPL (spooler) commands: 


DEST_USE PAR 
COPY wini_plain_txt (sends it to PAR printer port) 
SPLwind_PLAIN_txt (uses the SPL spooler job fo print a file to a PAR printer port in the background). 


| tend to find it best to group all my executable programs into one directory and point PROG_USE to 
that one. | also set DATA_USE to point to my main drive. WINI_. DEST_USE is just used for the default 
printer port. My boot program contains lines like this: 


200 PROG_USE Win1l_Progs_ 
210 DATA_USE Wini_ 
220 DEST_USE Par 


Many systems impose a limil of 32 characters on a default name. This is in keeping wilh the maximum 
filename length of 36 characters. After all, if you have a long 32 character default name, it only leaves 
4 characters for the rest of the filename, so you can understand why! 


Checking The Settings 


Sometimes you may forget what defaults you have set. This is where the three functions DATAD$., 
PROGD$ and DESTD$ come in. These request and return the relevant information from the system: 


PRINT PROGD$ returns the default set with PROG_USE 

PRINT DATAD$ returns the default set with DATA_USE 

PRINT DESTD$ returns the default set with DEST_USE 

An additional command DLIstT prints a list of all three settings. 


Using these extensions youll quickly realise that the system can only have one default for the entire 
computer. in other words, when you set PROG_USE “Win1_" it applies to all programs. It is not possible 
for each program to have a separate setling. Also, not all programs understand these defaults - life is 
not always easy! In a future article I'll show how to work around these limitations for awkward 
programs. 


Default Defaults 


When you first start a QL or emulator, these defaults are usually sel to one of the drives in the system 
and no directory. If your system has only floppy disc drives and no ard disc drive. it will usually set 
PROG_USE to FLPi_ and DATA_USE to FLPI_ (on some sysiems with two disc drives DATA_USE may 
be set to FLP2_), and DESTDS is usually a serial port or printer device such as PAR or SERL 


Navigation 


Some extensions are usually provided lo navigate the defaults up and down a directory tree. 
Personally, | rarely {if ever) find the need to use these, bul they are there. Normally, these three 
commands work on the DATA_USE default name, but if the PROG_USE name happens lo be the same 
they will affect that too. 


DDOWN name ~ moves down the tree, adds ihe name given to the default, so if the default happened to 
be Winl_ and the command was DDOWN Xchange the default would now become Winl_Xchange_. A 
subsequent DDOWN Quill would change the default to Winl_Xchange_Quill_ 


DUP - moves up the tree by removing the last directory name, so if the default was set to 
Winil_Xchange_Abacus_, a DUP would make it Winl_Xchange_ and a second DUP would make it just 
Wint_ 


DNEXT - moves up and then down a different part of the directory tree. 


Separating Directory And Filename 


In some ways, the QL filing system is a bil restrictive. Apart from the 36 character total name length 
limit, it's also hard for a program to work out which part of a name is a directory and which is the 
filename part. 


Most operating systems use specific symbols in a filename to separate the directory and filename, for 
example on Windows we might save something to CAQLfiles\lettertxt. Here we know that the drive 
name is C;, the directory name is indicated by the backslash characters (directory called QLiiles) and 
the filename is the bit after that last backslash, here ‘leltertxt’. The QL is a bit more simplistic in this 
respeci and the directory separator character can also be part of the filename. potentially making it 
hard to work oul which ts the directory name part, and which is the filename part. 


There is a solution, but it's not obvious and requires alittle bit of devious code to ask the system 
which is the directory, then subtract from the full filename (or full ‘path’ name as it's sometimes referred 
to). The answer lies in the use of the FNAME$ function, which returns the name of a file normally, or of 
the directory partif you open a channel using the FOP_DIR commana: 


LET f$="Winl Xchange _test_doc" 
LET channel=FOP_DIR(f$) 

PRINT FNAME$(#channel) 

CLOSE #channel 


This prints Xchange, the name of the directory containing the file called TEST_doc. Note that it 
doesn't return Xchange_ only the part before the underscore, so you need to take that into account. 
Also, not including the drive name. 


Separaling the directory path and the filename needs a bit of juggling like this (I wrote an article about 
Directory Names back in Volume 10 Issue 4 of QL Today). 


First, we use FNAME$ to return the full path and filename without the drive name: 


LET f$="Wini_Xchange_test_doc" 

LET ch=FOP_IN(£$) 

LET fullname$=FNAME$(#ch) 

CLOSE #ch 

LET ch=FOP_DIR(f$) 

LET dirname$=FNAMES$ (#ch) 

IF dirname$<>"" THEN LET dirname$=dirname$&'_! 

CLOSE #ch 

LET filename$=fullname$(LEN(dirname$)+1 TO LEN(fullname$) # 
PRINT filename$ 


which (eventually!) prints “lest_doc’ 


Conclusion 


Direclories are a very useful and sometimes underused facility on modern QL systems. They take a 
bit of gelling used to but once you've got used to them you'll wonder how you ever managed without 
them. The main advice is lo remember that the length of a directory name and filename combined 
must nol exceed 36 characters and try to plan ahead what names you intend to use because if you 
change your mind later it can be a very fiddly job to make big changes. 
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[2C Interiace tor QL Emulators 
Pant 6° (Comection) pe 


Some of you may have noticed my deliberate mistake in the last issue of QLToday | did not include the 
software listing!!! Completely my faull. So here are the missing listings. 


See the 12C Interface article listing in QLT Vol 17 issue 1 page 40. You need lines 1000 to 3090 from 
this listing. Then merge it with the following listings. 


10 REMark I12C test routines 
20 [26_init 
30 I2¢_Start 


50 MCP_init 

60 PRINT 

70 PRINT "LED Flash (Port A)" 
80 ledflash parallel8$,"A" 

90 PRINT 

100 PRINT "LED Flash (Port B)" 
4110 ledflash paralle18$,'"B" 
120 PRINT 

130 PRINT “LED Flash (Port A)" 
140 ledflash parallel7$,"A" 
150 PRINT 

160 PRINT "LED Flash (Port B)" 
170 ledflash parallel7$,"B" 
180 PRINT 

190 PRINT "All LED Flash" 

200 allledflash 
210 PRINT 

220 PRINT "LED Binary Count (Port A)" 
230 ledcount parallel8$,"A" 

240 PRINT 
250 PRINT "LED Binary Count (Port B)" 
260 ledcount paralle18$,"B" 

270 PRINT 
280 PRINT "LED Binary Count (Port A)" 
290 ledcount parallel7$,"A" 

300 PRINT 
310 PRINT "LED Binary Count (Port B)" 
320 ledeount parallel7$,"B" 

330 PRINT 

332 PRINT "LED Chase" 

335 ledchase 


340: 

350 PRINT "End ": CLOSE#3: STOP 
360: 

500 DEFine PROCedure monitor 

510 cg="" 


520 REPeat test 

530 a$-INKEYS(#3) 

540 IF a$="" THEN GO TO 530 
550 ch=c$ha$ 

560 END REPeat test 

570 END DEFine monitor 


arama 


Lines 1000 to 3090 from QLT 17 


4000 
4010 
4020 


4030 


4040 
4050 
4060 
4070 
4080 
4090 
4100 
4110 


4120 : 


5000 
5010 
2020 
5030 
5040 
5050 
5055 
5060 
5070 
5080 
5090 


5100 : 


6000 
6010 


6020 
6030 
6040 
6050 


6060 
6070 
6080 
6090 
6100 
6110 
6120 
6130 
6140 
6150 


6160 


6170 
6180 
6190 


6200 


6210 
6220 
6230 
6240 
6250 
6260 
6290 
6300 
6310 


DEFine PROCedure ledflash(dadd$, port$) 
FOR a=1 TO 10 
IF port$="A" THEN PRINT#3;"s-";dadd$;" 12 ff p";CHR$(13);:REMark s-start message to USB to 
I2C converter, p=end of message to USB to 12C converter. 

IF port$="B" THEN PRINT#3;"s-";dadd$;" 13 ff p";CHR$(13);:REMark s-start message to USB to 
I2C converter, p=end of message to USB to I12C converter. 

non_print_reply:REMark Stops printing the USB to 12C reply also ensure serial buffer is cleared 
PAUSE 25 
F port$="A" THEN PRINT#3;"s~";dadd$;" 12 00 p";CHR$(13); 

F port$="B" THEN PRINT#3;"s-";dadd$;" 13 00 p";CHR$(13); 

non_print_reply:REMark Stops printing the USB to 12C reply also ensure serial buffer ig cleared 
PAUSE 25 

NEXT a 

END DEFine ledflash 


DEFine PROCedure ledeount(dadd$, port$) 

FOR a=0 TO 255 

hhex$=HEX$(a, 8) 

PRINT a3" "shhex$;" "5 

lhex$=hex_case_con(hhex$) 

F port$="A" THEN PRINT#3;"s—";dadd$;" 12 "&lhex$&" p"; CHR$(13); 

F port$="B" THEN PRINT#H3;"s—";dadd$;" 13 "&lhex$&" p"; CHRS(13); 

non_print_reply:REMark Stops printing the USB to 12C reply also ensure serial buffer is cleared 
PAUSE 5 
NEXT a 
END DEFine ledeoun 


DEFine PROCedure MCP_init 

PRINT#3 ; "s—"jparalle18$;" 00 O00 p'';CHR$(13);:REMark set mep23017 port "A" mode IODIRA to 
output 
non_print_reply 
PRINT#3;"s—"; parallel8$;" 01 00 p";CHR$(13);:REMark set mep23017 port "B" mode B to output 
non_print_reply 
PRINT#3;"s—"; parallel7$;" 00 00 p";CHR$(13);:REMark set mep23017 port "A" mode JODIRA to 
output 
non_print_reply 
PRINT#3 ;"s-"; paralle17$;" 01 00 p";CHR$(13);:REMark set mep23017 port "B" mode B to output 
non_print_reply 
END DEFine MCP_init 


DEFine PROCedure allledflash 
PRINT#3 ; "A40"; CHRS(13); 
non_print_reply 
FOR a=1 TO 10 
PRINT#3;"s—";paralle18$;" 12 ff p s-";parallel8$;" 13 ff p s—";parallel7$;" 12 ff p s-"; 
parallel7$;" 13 ff p";CHR$(13);:REMark s-start message to USB to 120 converter, p=end of 
message to USB to 12 converter. 

REMark PRINT#3;"s 13 ff p";CHR$(13);:REMark s=start message to USB to I2C converter, p=end 
of message to USB to 12C converter. 

non_print_reply:REMark Stops printing the USB to 12¢ reply algo ensure serial buffer is cleared 
PAUSE 25 

PRINT#3;"s-"; parallel18$;" 12 00 p s-";paralle18$;" 13 00 p s~";parallel7$;" 12 00 p s~"; 
paralle17$;" 13 00 p";CHR$(13);:REMark s=start message to USB to I2C converter, p=end 

of message to USB to 12C converter. 

REMark PRINT#3;"s 13 00 p";CHR$(13);:REMark s=start message to USB to I2C converter, p=end 
of message to USB to I2C converter. 

non_print_reply:REMark Stops printing the USB to I2C reply also ensure serial buffer is cleared 
PAUSE 25 
NEXT a 
END DEFine allledflash 


DEFine PROCedure ledchaseup 

FOR a=1,2,4,8,16,32,64,128,0 

PRINT#3;"s~"; paralle18$;" 12 ";HEX$(a,8);" p";CHR$(13); 
non_print_reply 


6320 
6330 
6340 
6350 
6360 
6370 
6380 
6390 
6400 
6410 
6420 
6430 
6440 
6450 
6460 
6470 
6480 
6490 
6500 
6510 
6520 
6530 


PAUSE 1 

NEXT a 

FOR a=1,2,4,8,16,32,64,128,0 

RINT#3; "s—"j;paralle18$;" 13 "j;HEX$(a,8) 5" 
non_print_reply 

PAUSE 1 

NEXT a 

FOR a=1,2,4,8,16,32,64,128,0 
PRINT#H3;"s~";parallel17$;" 12 ";HEX$(a,8);" 
non_print_reply 

PAUSE 1 

NEXT a 

FOR a=1,2,4,8,16,32,64,128,0 
PRINT#3;"s-";paralle17$;" 13 ";HEX${a,8);" 
non_print_reply 

PAUSE 1 

NEXT a 

END DEFine ledchaseup 


DEFine PROCedure ledchasedown 
FOR a=128,64,32,16,8,4,2,1,0 
PRINT#3;"s—"; parallel7$;" 13 "j;HEX$(a,8);" 


6540 non_print_reply 

6550 PAUSE 1 

6560 NEXT a 

6580 FOR a=128,64,32,16,8,4,2,1,0 

6590 PRINT#3;"s—";paralle17$;" 12 ";HEX$(a,8) 5" 
6600 non_print_reply 

6610 PAUSE 1 

6620 NEXT a 

6630 FOR a=128,64,32,16,8,4,2,1,0 


6640 
6650 
6660 
6670 
6680 


PRINT#3;"s-"; parallel18$;" 13 ";HEX$(a,8);" 
non_print_reply 

PAUSE 1 

NEXT a 

FOR a=128,64,32,16,8,4,2,1,0 


6690 PRINT#3;"s—";parallel8$;" 12 ";HEX$({a,8);° 
6700 non_print_reply 

6710 PAUSE 1 

6720 NEXT a 

6730 END DEFine ledchasedown 

6740 : 

6750 DEFine PROCedure ledchase 


6760 


6770 
6780 
6790 
6800 
6810 
6820 


pl"; CHR$(13) 


p";CHR$(13) ; 


p"; CHR$(13) ; 


p";CHR$(13) ; 


p"; CHR$ 


p"; CHR$ 


p"; CHR$ 


PRINTH3 ; "s—";paralle18$;" 12 00 p s—";parailel8$;" 13 00 p s—"j;parallel7$;" 12 00 p s—"; 


paralle17$;" 13 00 p";CHR$(13);:REMark s=start message to USB to I12C converter, p=end of 


message to USB to 12C converter, 
non_print_reply 

FOR ce=1 TO 10 

ledchaseup 

ledchasedown 

NEXT ce 

END DEFine ledchase 


QL on a Linus Stick 


Denar 


Introduction 

As many of you know, Dilwyn Jones has created 
a package of software that he distributes on a 
CD and you copy the contents to a USB stick 
this creating a QL on a Stick. it’s relatively simple, 
and works, provided you are using a Windows 
computer of course. 


Not everyone is, myself included, and Dilwyn has 


been asked on occasion if 
version available. Dilwyn is a sel 
non-guru, and asked on the Q 


here is a Linux 
{ confessed Linux 
L Users list for a 


volunteer, or two, to assist in the creation of QL 
on a Linux Stick. | volunteered ‘a long time ago" 
and since then have failed to create anything! 


How hard can it be? 


Background 

Ok, when you insert a USB stick, or CD into a 
Windows machine, the system takes over and 
mounts the device before looking for an aulorun 
script that tells it what to do next. This is very 
insecure and Windows allows people to turn off 
the ability to auto run ‘stuff’ from a freshly moun- 
ted device. Nol many people have turned it off 
and probably, not many know about it. Microsoft 
tend to hide away security details from their 
users and sel up weird and wonderful defaults 
that make the system totally insecure. 


For example, the administrator password on XP is 
blank. it tells you that on page 16 of a tiny, mea- 
ningless, waffling ‘manual’. My ZX-81 came with a 
far better manual! 


Another thing Windows does in the background 
is this. When you install Windows, you install 
everything. You get all the support files for any 
program Created with any of the Windows compi- 
ler or development tools. They are all there, hid- 
den away, This means that Windows developers 
don't need to distribute the support files - dlls etc 
- with their application binaries. Microsolt made 
great noises about this when comparing their 
tools to those from other companies like Borland. 
The Microsoft tools created far smaller binaries. 
They neglected to add that the reason was 
because Windows already had everything you 
needed” - whether or not you needed it! 


Linux is different. Yes there are lots of libraries 
installed - the equivalent of Windows dlls - but the 
only ones installed are those that are specifically 
required for any application you install. This 
makes sense as your hard disc isn't polluted with 
iles you will never need, taking up space and 
ime when you carry out a backup, You do back- 
ups don't you? ;-) So, when you install a new 
application on Linux, the installer (package mana- 
ger actually) is told what libraries are required to 
install and run this particular application, and goes 
off to get them. It makes sense. 


Security 

As mentioned above, Windows is incredibly inse- 
cure, Everything is already installed, so a problem 
in a dil or device driver could easily be used to 
faciilate illegal access to your computer and 
eilher access your files, data, bank or personal 
details and so on. {t can lead to your computer 
being used as part of a bot-net allack on some 
company or even, government. And all withoul 
you knowing aboul it. 


Having CDs and USBs auto execute some nasly 
software is simple enough on a Windows ma- 
chine. It's not impossible on Linux, but has a far 
lesser risk. There is, of course, autorun.sh on 
Linux CDs. These cause the CD to act like Win- 
dows and carry out some task after the device 
is mounted. Many desktop Linux distributions 
{aka distros) have auto-mount enabled so 
shoving a CD or USB will mount it for you auto- 
matically, But not all do this! 


Problems Problems 
So, in the Linux world where we have a more 
secure selup, we have three main problems in 
creating QL on a Linux Stick: 


* Not everything is installed, so a program's 
dependencies might not be there when we 
insert the USB stick. 

* Not all Linux distros will auto mount the USB 
slick on insertion. 
* Not all Linux distros allow autorun.sh to exe- 
cute on mounting a device. 


Potential Solutions 

| see two potential solulions to resolve the 
above. The first is to simple create a clone of the 
Windows version on QL on a Stick and let the 
user worry about dependencies etc. The huge 
problem with this method is simple, Dilwyn will 
get a huge number of emails saying ‘it doesn't 
work’ and they will {hen be passed on to me to 
sort out! This is a bad thing! (For both of us!) 


The second is to build a Live distro and install all 
the dependencies required on that, and then use 
that on the CD that Dilwyn distrioutes to the 
users. They then copy that to their USB and off 
they go, everything is fine. Or is it? 


The second oplion is the better of the two, but... 


More Problems 

A Linux live distro is one which runs directly from 
a CD or USB device. You plug it in, rebool and it 
boots up and loads the operaling system {rom 
(he device, rather than the hard disc, and it runs 
eilher from a ‘squash-fs” system on the CD or 
from RAM. 


Squash-fs is a compressed file system that 
allows much more data and applications to be 
squeezed onto a CD than the normal 650-700Mb 
would allow, It is decompressed on the fly as it is 
accessed, so it slows down the normal running 
of the system. 


aire oe 
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Some of the smaller distros copy themselves 
into RAM and run, very quickly, from there thus 
freeing up the CD to be used for other purposes 
- listening to music, burning backups and so on. 
Other distros run from the compressed file 
system on lhe CD, and run slower as a result. 
Sometimes very much slower as the CD has to 
be powered up, brought up to speed and then 
the data can be read - and it lakes time. 


The bonus to this type of Live distro is that you 
can ‘try before you buy’ and if you con't like it, 
simply don't use it, your computer remains un- 
touched completely, Nothing is written to the 
hard disc, nothing is read from it. You remain, pure 
and safe. 


So far, so good, but, unlike windows, you cannot 
simply copy the CD files onto a USB stick and 
boot from that, you need to install them correctly, 
nstalling usually means that you login lo the CD 
based system first and choose the option lo 
install to USB device and work from thal. 


Windows users are happy in that a USB device is 
mounted and available as a E: drive, or similar. 


Linux devices may be /dew/sdb or /dewsdc and 
so on, depending on your system. And then 
there are partitions on the device - /dewsdal, 
/Gev/sda2 and so on. Whal are they all about? 


Luckily, you don't need to worry about those but 
come installation to the USB device, you might 
need to consider them - you may be prompted 
to specily a partition size for swap space (your 
Windows virtual file), your root (/) partition and so 
forth. And of course, different live distros do a 
different partitioning scheme and use different 
uliities and so forth, Sigh! 


No One Said it Would be Easy! 


So far, I've managed to build a working Arch 
Linux, 32bit set up where on login, | get a menu 
with all the options lo run any of the emulators, 
read the documentation or run the utilities. This is 
the most progress | have had. 


| have a nice QL boot screen when you first run 
up the Linux system, and when the user chooses 
{o boot (unfortunately not with F1 or F2) il auto- 
matically logs you in as the Qdos account where 
the menu is set to aulo run. It works! 


Unfortunately, the tools to create a live booting 
system from my installed development system 
appears to change things. My nice screens and 
my ados user vanish and the menu doesn't aulo 


fun. 


Frustrating? You bet! 


nstaling this (non-working) live distro 1o a USB 
Slick, and booting it on my wife's laptop results in 
a pause looking for some device, then a drop 
into a rescue session. Not very desirable for 
people who might not understand Linux. Back to 
the drawing board. 


should add, the bootable USB version was 
created with a utility named “Unetbootin’- it 
appears not to work. | have to use this utility 
because Arch Linux doesn't come with an 
installer as such, it's up to you, the Linux guru, fo 
sort out installing an Arch system. 


Maybe some other base distro would be better 
and a bit more user friendly? Well, I've looked at 
Linux Mint {an excellent distro if you are coming 
over from the ‘dark side’ for the first lime} and 
unfortunately, | have been unable to follow the 
outdated) wiki where the information is given on 
how to reorganise a Mint live distro to your own 
requirements and burn an iso file to boot from {or 
install on a USB) - but al least Mint comes with an 
installer. 


* OpenSuse. | tried fo go online and create a 
live distro, It too failed to work. 


* Puppy Linux, supposedly easy to use and 
small. It runs totally from RAM. Well, on my 
laptop, it did boot quickly and run, but it was 
setting itself to a huge sized screen and the 
mouse pointer couldn't get to some of the 
options, icons and so on. Not good. 


* Ubuntu. Nope, a respin here failed as well. 


Sounds like the only people who appear to be 
able to create their own live distros, based on a 
‘production’ one, are the same people who pro- 
duce the production ones, doesn't it. Hmmm. 
Linux is excellent, but this doesn't make me 
happy! 


Even More Problems 

In the original QL on a Stick, Dilwyn supplied a 
few utilities. QStripper and WXQT2 for example. 
These are good tools (declaration of interest - 
QStripper is mine!). One of the first things | did 
was lo replace the Windows version of QStripper 
with my own compiled for 32 bit Linux version. It 
runs as a native Linux program ralher than a 
Wine emulated Windows program. (Although it 
runs fine either way!) 


WXQT2 on the other hand, is the Windows 
version and runs under wine. This is ok, and 
everything appears to work, until you try to get 
help. If pops up a message saying lo enable an 
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environment variable to enable help, and restart 
the program. Sounds easy but under wine, it 
doesn't work. 


No worries, the code is supplied and it's built to 
be compiled under Windows, Mac or Linux. 
Except, the versions of the compiler and support 
tools have moved on a long way since this ulility 
was first invented. There are huge numbers of 
errors that prevent a proper working Linux 
version from being created! 


Searching online for a Linux version also turned 
up nothing. It’s a utility that is distributed as source 


code and you have to compile it. So my next task 
is to dig into the source and try to work oul, and 
fix, all those warnings and errors to get a working 
Linux version. Another problem to be resolved 
before we get QL on a Linux Stick. 


Good News? 

At least | have a project name - QL on a Linux 
Slick is a bit unwieldy, I'm calling it QLOLS for 
now! Here are a couple of screen shots showing 
the system as it is now. The first is the boot 
menu. 
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And the screenshot on the next page shows the 
system up and running with a copy of Wolfgang 
Lenerz's SQSQmulator running alongside the 
menu system that is presented on login. 


If you look very closely at the task bar above, 
you will notice a small union flag - it's the third 
icon in from the left. By clicking on that flag, you 
can change the keyboard layout between almost 
any number of regional variations. | have it 
configured for UK, Germany, France, Belgium and 
so on at the moment, but it's simple to add 
others - US for example. 


if Dilwyn looks closely at the image above, he 
might notice that the desktop wallpaper (do you 
really wallpaper a desktop? | don't! Surely it's a 
tablecioth!) is blatantly stolen from his own 
website's "QL Logo’ seclion. 


And Finally! 


Finally, if you are looking for a QLOLS system, 
there might be one day, when | resolve the 
above problems. But if you were asking why 
there isn't one, at least you know now! 


If you have a properly compiling version of 
WXQT2, that compiles under GCC 4.6 and 
WxWidgets 2.8, then I'd be glad to have a copy, 
thanks. Youll save me a lot of work in getting the 
utility up to date. 


That request applies to the dependencies for 
the utility QLTools etc need also to be compiled 
for Linux. I'm pretly certain thal running a Linux 
version of the GUI talking to the Windows 
versions of the actual utilities, just isn't going lo 
work! 
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Glossary of Abloreviations anc Terms 
Parr EARGORS) by Dilwym Jones 


and Lee Prihret 


RAM Random Access Memory, the memory used in the QL. You can read information 
from and write information to this type of computer memory. RAM is also the 
device name used by the QL for ramdisks. Usually up to 8 of these ramdisks can 
be used on a QL, with names ranging from RAMI_ to RAM8_ 


RAMdisk A QL device for storing information in memory in a manner broadly similar to a 
floppy disk or Microdrive cartridge. Fast, but conlents lost when you switch off or 
reset the QL. Useful for copying files to temporarily on a single drive computer, for 


example. 

Recursion A programming technique whereby a routine calls itself one or more limes until a 
given condition is met. A very difficult concept for a beginner in programming to 
grasp! 

Reference See ‘Pass By Value Or Reference’ above. 


Register 


RISC 


RGB 
ROM 


RomDisq 


RS232C 


RTC 
RTM or RTFM 


RTS 
R/W 


SATA 


SAV 


3B 
SBASIC 


S*BASIC 
SCR 


Scripting 


A part of a CPU which holds some binary value. May be an 8-bit value, 16-bit and 
so on. A value in a register can be processed much fasler by a CPU than when 
that value is in a RAM localion. 


Reduced Instruction Set Computing, supposedly the fastest and most efficient 
way of compuler processing 


Red, Green, Blue. Three components of a colour video monitor signal 


Read Only Memory, or memory which you can only read information trom. Once 
information has been programmed into this type of memory, that's it, it can’t be 
changed. The QL's operating system, a program or collection of small utilities 
which determines how the QL starts up and operates, is stored in this type of 
Tnemory. ROM is also the device name for a RomDisq (qv) flash memory expansion 
card. You would use ROMI_ for the RomDisq like you would use MDV1_ for a 
microdrive, for example. 


Flash memory card from TF Services. Plug into the EPROM slot behind the QL and 
contains from 2MB to 8MB of RAM. Uses the device name ROMI_ 


| don’t know what the letters stand for but basically this is the name of the system 
used for sending data I bit at a time down a serial link such as the SERI or SER2 
sockets on the QL 


Real Time Clock 


Something a trader or programmer is likely to tell you when you haven't read the 
instructions. Stands for Read The Manual, but I'll let you guess what the F in the 
second version stands for. 


Request To Send, an RS232C signal pin 


Read/Write. Getting information from or sending information to something 


Serial Advanced Technology Attachment, an interface allowing fast read/write 
access to hard disk drives 


Filename extension used for BASIC programs saved with the QSAVE command. 
This type of file is a tokenised BASIC program, as opposed to BASIC programs 
saved as plain text files with the ordinary SAVE command. 


SuperBASIC 


An enhanced version of the QL's SuperBASIC, supplied with the SMSQ operating 
system. A variant of the name is S*BASIC, with the *' acting as a wildcard 
character allowing the name to refer to eilher SuperBASIC or SBASIC (or 
sometimes both). 


Generic term used to refer to both SuperBASIC and SBASIC. 


Screen window. A type of window on the display where you can PRINT 
informalion to. SCR windows have no keyboard facility, so you cannot use the 
INPUT command {o allow ihe user to enler any information in that type of window 


Essentially, what we on the QL have thought of as ‘programming’. The task of 
writing code in a high level language such as BASIC which is then interpreted by 
the computer into machine code as the program runs. 


SD 


SDUMP 


SER 


SERNET 


Server 


SGC 


Shriek 
SIMM 
SMSQ 


SMSQ/E 


$s 
Siok) 


Stack 


Stipple 


String 


Single Density - term used to refer to the recording ‘density’ of a floppy disk. Not 
often seen used with a QL. ‘SD’ also refers to a type of flash memory card, called 
a “Secure Digital’ card. 


The name of the Screen Dump software built into some systems, such as Gold 
Card and Trump Card. The term ‘screen dump’ refers to the act of printing a copy 
of the screen on paper, or less commonly the act of saving a copy of the screen 
as a file on disk. 


One of the serial ports on a QL. This is the name by which these sockets on your 
computer are known to the computer and to the sofiware it runs. On a PC, the 
sockets might be called COMI: or COM2;, but the QL emulators such as QPC and 
QXL always refer to them as SERI or SER2. SER is an abbreviation for SERIAL, 
which means that every bit of information sent to these ports is sent one alter the 
other, in serial fashion, rather than say 8 bits at a tine. See PAR above 


Software system used to control a group of computers (normally running the 
SMSQ/E operating system) connected together by serial port cabling. 


A computer which provides services used by other computers, e.g. the user might 
be using a program or web page on his computer which was stored on a remote 
server and sent to the user's computer to run or view. 


Super Gold Card, an enhanced version of the Gold Card expansion card for the 
QL with 4MB of RAM and a 68020 processor 


Alternative name used by some programmers for the exclamation mark symbol 
Single Inline Memory Module, a type of memory card used by PCs 


Operating system for the QXL, from Miracle Systems. Unlike SMSQ/E, this does 
nol include the Pointer Environment. The letters SMS were never well defined, 
some say it stands for Single-user Multitasking Systern, while others say it stands 
for Small Microcomputer System, and others say Smart Micro System! 


Extended version of the SMSQ operating system for the QL. This version comes 
with the equivalent of the pointer environment files PTR-GEN, WMAN and 
HOT_REXT built in and offers a large number of additional features over SMSQ, 
e@g. additional devices and device features, device buffering and the ability to 
change display resolution 


Single Sided, Refers to a type of floppy disk, or its drive 


The QL Sampled Sound System. Enhanced sound system used by Amiga QL 
emulator, Q40, Q60 and QPC2 


A sort of list where values are stored in a pile of numbers, and values can only be 
added lo or taken away from the end of the stack. Often this is just a temporary 
storage area fro a number, [rom where it can be recovered laler Computers may 
have a system slack exclusively used by the computer's operaling system, and a 
user stack exclusively used by the user's program. 


Although a standard QL has only 4 or 8 colours lo display. you can use a 
combination of pixels next to each other with two different colours which look a 
bit like a third colour, e.g. lots of adjacent red and white pixels might look like a 
shade of pink. Sometimes referred to as a pattern of colours. 


A data structure which holds text, e.g. LET a$ = “Hello” 


Structured Programming The art of writing programs which do not refer to line numbers. In other 
words, in SuperBASIC, programs which do not use keywords like GOTO and 


GOSUB 

SuperBASIC The QL version of BASIC, this was designed by a lady called Jan Jones for 
Sinclair 

SVGA Super Video Graphics Array. A PC graphics card, On the QXL or QPC an SVGA 


mode implies a display of size 800 pixels across and 600 down 


SW Shareware, a method of software distribution where the author lets you use either 
a cut-down version of a program, or a time-limited piece of software. If you like 
and wish to continue to use the full version of the software, you are expected to 
contact the author and pay a fee, for which you'll sometimes get a non-limited 
version of the software and product support. Sometimes used as an abbreviation 
for “software” only 


Syntax Rules about the correctness of a part of a program. This is pretly much the same 
‘ as lhe meaning of he word when used in conjunction with spoken language 

(nouns, verbs, etc). Syntax defines how a part of a program should be written, e.g. 

the syntax of a LET command such as LET a$ = ‘Hello’ dictates that the word LET 

is followed by a variable name, then an equals symbol, then a value to be assigned 

to that variable. Think of it as the grammar of a command or function in a program. 
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Introduction 


In the last issue, we ended up with an application that was getting somewhere. But it's not finished yet. 
This issue we will look at what happens when the user requests that we load a symbol file. In this 
article, as before, we shall add code gradually, starting simple and getting more complicated as we go 
on. 


Gwas! Update 

George has updated gwasl to version 2.05 to fix a slight bug in error handling. To be sure you have 
the latest version, please download it from http:/gwiltprogs.info/gwaslp08.zip. We shall be using this 
version {rom now on. 


Errata 
In the previous edition, Volume 17 Issue 2 dated December 2012 to February 2013, George Gwill 
spotted a couple of errors in my code. 

* In the IW_LPRINT sub-routine, at label IWP_PRINT, we have the following: 


iwp_prnt moveq #io_sstrg,4d0 
move.w (a3)+,d2 
beq.s iwp_exit 


The code is incorrect in that it introduces a bug. If there is no string to print, the code exits directly to 
iwp_exil where DO is tested and the condition codes set. Unfortunately, this means that the condition 
codes will be set to reflect the fact that DO is currently sitting with the value HOLSSTRG and not an 
error code. This is a bad thing! 


The code above must be changed as follows: 


iwp_prnt move.w (a3)+,d2 
beq.s iwp_exit 
moveq #io_sstrg,d0 


In this corrected version, DO will contain zero on return from the previous trap and thus, on early exit 
lo IWP_EXIT, the condition codes will be set to reflect this zero value, and the code will assume that 
all is well, which it is. The window has been cleared and nothing has been printed - which is exactly 
what is desired. 


ae 


* Also in the sub-routine IW_INPUT on.page 22, | have a comment near the bottom of the page th 
details a bug in the documentation for the WM_ENAME vector The comment is incorrect and shou 
be removed. This has arisen due to a misunderstanding of the documentation, on my part. 


| assumed that when the docs mentioned that the condition codes would be set, that what they rea 
meant was thal DO would be set. A completely incorrect assumption on my part. However, | wrote th 
library routine with that assumption in mind. As it turned out, after an exchange of emails with George. 
the manual is correct and | am wrong. 


<i, 


D< 


If you leave the code the way it is, DO will be set to negative, zero or positive as | origina 
misunderstood the manual to say. It does no harm, but the comment itself is wrong and should b 
removed as there is not a bug in the manual. 


Oo<= 


This also means that on page 21. the first line of the note, where it says that ‘DO will be zero if ENTER 
was pressed..to terminate the edit.” it is wrong. That whole paragraph can simply be ignored. Typpex 
it out if you must! ;-) 


My apologies for these problems, and my thanks to George for his assistance in resolving my issues. 


* George also pointed out that in the routines CP_STRING and AP_STRING, where the test for a zero 
length string is made, it is not necessary as the DBF instruction will detect this and do nothing anyway. 
What George says is true, but | tend to like to be explicit in my code. To this end, you can, if you wish 
fo save a couple of byles and clock cycles, remove the BEQ.S CS_EXIT and/or BEQS AS_EXIT 
instructions from near the start of these routines. 


* George further pointed oul my use of the BLT instruction as opposed to the BMI command. Once | 
checked my documentalion, | discovered thal George is correct — although the conditions under 
which BLT wouldn't work are unlikely, | have decided to correct the code. There are three occasions 
where the instruction BLIS xx_EXIT where xx is a two letter prefix, should be changed to BMIS 
xx_exit instead. They three locations are in the routines at SYM_HIT, LIB_HIT and BIN_HIT. Please 
change all three BLT instructions to BMI. 


What's the difference? Well, my code is looking for a negative number, and if found, currently bales out 
via the BLT instruction, How do you determine whether a number ts negative or not? The N flag tells 
you. If the N flag ts set, the number in question is negative, otherwise, it is positive. 


The BMI instruction checks the N flag and branches accordingly, The BLT instruction, on the other 
hand, will branch only if the N flag is set and the V (overflow) flag is not set, or if the V flag is set and 
the N flag is nol. 


* And finally, here's a couple | spotted myself. Unfortunately, because I'm running on QPC with a 
virtual] 68020, the following two bugs don’t cause an exception, however, running on a standard QL, 
they would. 


The code al LILUNAV and LILAVAIL currently looks like this: 


li_unav move.1 #$11114411,ws_litem+1li_libfile(at) 
bra.s li_rdrw 


li_avail move.1 #$01011101,ws_litem+li_libfile(al) 


li_rdrw moveq #-1,43 
jmp wm_ldraw(a2) 


The problem is, LILLIBFILE is an odd value - it’s $03. Although ALL and WS_LITEM are both 
guaranteed to be even, the effective address of the MOVEL is an odd address. As | mentioned, this 
works perfectly well on QPC with its 68020 processor, but the 68008 in our bare bones QLs will raise 
an address exception. We need to change the code as follows: 


li_unav move.b #wsi_mkun,ws_litemt+li_libfile(ail) Make Libfile unavailable 
move.w #$1111,ws_litem+1i_load(a1) Make Load and Save unavailable 
move.b #wsi_mkun,ws_litem+li_binfile(al) Make Binfile unavailable 
bra.s li_rdrw 


li_avail move.b #wsi_mkav,ws_litem+li_libfile(a1l) Make Libfile available 
move.b #wsi_mkav,ws_litem+1li_load(a1) Make Load available, Save 
stays Unavailable 
move.b #wsi_mkav,ws_litem+li_binfile(al) Make Binfile available 


li_rdrw moveq #-1,43 
jmp wm_ldraw(a2) 


Another Library 

The processing for the ‘Load’ and "Save" loose items requires a bit of file processing. | have a library 
for this, as you might expect. So, without any further ado, here it is. Mine is called 
wint_source_qltoday_openfiles_asm at the momenl, and is simply included as a plain source file, it’s 
not a proper library yel. {{ you save your file in a different place, please be sure fo change the name in 
the ‘in’ command. 


; This 


file contains useful utilities for opening files etc. 


; It's just crying out to become a library! ;~) 


; F_OPEN ~ Open a file. Old Exclusive mode. 

; F_LOPEN_IN - Open a file for input. 01d Shared mode. 
; F_LOPEN_NEW - Open a new file. New Exclusive mode, 

; F_OPEN_OVER -— Open overwrite. New Overwrite mode. 

; FLOPEN_DIR - Open a directory. Open Directory mode. 
j F_CLOSE - Close any open file. 

3 F_SYNC - Flush buffers to device. 

3 FLPOS_ABS - Set absolute file position. 

; F_POS_REL ~- Set relative file position. 


Entry Registers. 


: 
z 
; Unless otherwise specified, all routines use the following registers 
3 on entry: 

j 

J 


; AO.L Pointer to QDOSSMQ string defining the file name. 
Exit Registers. 


j 
j 

j Unless otherwise specified, all routines exit with the following 
; register usage. Any register not listed will be preserved by the 
} routines. 
2 
+ 
, 


; DO.L Error code. Zero = no errors. 
; AO.L Channel id. 
; Flags - Z set to reflect the value in DQ. 


io_openx equ 0 SuperBasic OPEN 
io_open_in equ i SuperBasic OPEN_IN 
jo_open_new equ 2  SuperBasic OPEN_NEW 
lo_open_over equ 3 SuperBasic OPEN_OVER 
io_open_dir equ 4 No SuperBasic equivalent. 


move.1 d3,—(a7) Save D3 
moveq #io_openx, d3 I0 Open code 
bra.s f_open_all Go do it, and exit. 


f_open_in 
move.1 d3,-(a7) 
moveq #io_open_in, d3 
bra.s f_open_all 


f_open_new 
move.1 d3,—(a7) 
moveq #io_open_new, 43 
bra.s f_open_all 


f_open_over 
move.1 d3,-(a7) 
moveq #io_open_over, 43 
bra.s f_open_all 


__open_dir 
move.1 d3,-(a7) 
moveq #io_open_dir, a3 


jeeesesssscsstscsssccsssssccssscccssssssssssseeeececsesseeceseesscscs 
f_open_all 
movem.1 di-d2/al,~—(a7) Save working registers 
moveq #io_open,d0 IO_OPEN trap code 
moveq #-1,d1 File is for this job 
3 D3 already set 
i AO already set 
trap #2 Do it 
movem.] (a7)+,d1-d2/al Restore working registers 
move.1 (a7)+,d3 Plus D3 from above 
tst.1 do Set Z flag 


rts Done 


Serer 


The first few routines are all to do wilh opening files. All that they do is set the required open mode in 
D3 then branch down to doing all the hard work at {_open_all. D3 is also preserved by the individual 
routines as we need to keep it safe from changes. 


On arrival at {_open_all, we preserve all the other working registers and call out to QDOSMSQ to 
open the tile for us. On return, AO holds the channel id and DO any potential error codes. After 
restoring all lhe working registers, and D3, we set the flags according to DO's error code and exit. 


Entry Registers: 


; AO.L Channel Id 


* 
j 
J 
ss 
; Exit Registers: 
, 
, 
s 
; 


; DO.L Error code (channel not open) 
; AO.L Corrupted. 
; Flags Z set according to DO. 


f. close 
moveq #io_close, dO Close file trap code 
trap #2 Do it 
tst.1 dd Set Z flag 
rts Done 


The {_close routine simply closes the channel id passed in AQ, and returns with any errors in DO and 
the Z flag set accordingly. 


2 
; F_POS_ABS - Set the current file position pointer to an absolute 
; position in the file. 


2 

3; Entry Registers: 

J 

j D1.L File position required. 
; AO.L Channel Id. 


; Exit Registers: 


, 

; DO.L Error code. 

3; D1.L New file position. 

; Flags Z set according to DO. 


f __pos_abs 
moveq #fs_posab,d0 Abs position trap code 
bra.s f_pos_all Do it 


3; F_POS_REL - Set the file position to a new location relative to the 
5 current location 


f pos_rel 
moveq #fs_posre, dO Relative position trap code 


f_pos_all 


movem.1 d3/a1,—(a7) Preserve working registers 
moveq #-1,d3 Timeout 
3 DO already set to trap code 
5 Di already set to file location 
: ; AO already set to channel id 
trap #3 Do it 
movem.1 (a7)+,d3/al Restore registers 
tst.1 do Set Z flag 
rts Done 


; Entry Registers: 


; AO.L Channel Id. 


Exit Registers: 


, 

3 

3 DO.L Error code. 

j Flags Z set according to DO. 


f_flush 
movem.1 d1/d3/a1,—(a7) Preserve working registers 
moveq #fs_flush, dO Trap code 
moveq #-1,43 Timeout 
4 AQ already set to channel id 
trap #3 Do it 
movem.1 (a7)+,d1/d3/al Restore registers 
tst.1 do Set flags 
rts Done 


The above routines carry out useful file flushing and positioning facilities. As ever the channel id is 
passed in AQ, and for the file positioning routines, a file location in DLL. After preserving the working 
registers, the routines simply call out lo QDOSMSQ to do the hard work before restoring any working 
registers and exiting with the Z flag sel according to the error code in DO. 


The following one line needs to be added to the end of libgen_asm to include the above library of 
useful file handing routines. 


in wini_source_qltoday_openfiles_asm 


It should be added after Ihe existing line thal includes my pe_utilities_asm source file. 


Load Processing 
When the user hits the ‘Load’ loose item, the file named as the Symbol file, is opened for reading. It is 
(hen processed in lwo passes. 


The first pass simply counts the number of code offset lines that will be added to the menu. This is 
done by looking along the entire line of text read in, for the appearance of the characlers *+' as these 
{wo indicate that the entry is for a code offset rather than an equale. If we find what we are looking 
for so we increment the counter Any errors cause an immediate return with the Z flag indicating 
success or failure, 


The second pass resets the {ile position back to the slart, and begins reading again. This time. for 
each entry that represents a code offset, we extract the label name from the eniry, and add it to the 
puffer alocated for the application menu. Again, in the event of an error, we return with the Z flag 
holding the success or failure status. 


If all is well, then at end of file, the file will be closed and the bufler added to the application 


sub-window as a menu, All items in the menu will be selected by default. If the file loads correctly, the 
*Save’ loose item will be enabled and the ‘Load’ loose ilem will be reset to available. 


| did consider reading the _sym file directly and bypassing the need to create a _sym_lst file. | got as 
far as diagnosing the internal structure of a gwas! _sym file and even worked out a fairly simple 
manner of processing the load requirements. Unfortunately, George advised that | stick with the 
_sym_lst file as it is identical whether the original _sym file was crealed with gwasl or gwass ~ as 
these produce a different _sym file format. 


| did a quick test using gwass instead of gwasl and sure enough, the _sym files are different. Equally, 
the _sym_lst files are also different, so {need lo scan each line read in from the file looking for the 
special characters | want instead of just checking a specific location in the line. Never mind, this way, if 
George changes things, LibGen will still work. 


LibGen Code 


As with the other hit routines. we start off quite simple. The following code is all that is required as the 
main “Load” loose item hit routine: 


psr load_hit Do it all. 

movem.1 (a7)+,d5~d7/a0-a4 Restore important registers. 

move.w #$0101,ws_litem+li_load(al) Only works because li_load is even! 
bra li_rdrw - Load = available, Save = available. 


; This code carries out all the nasty work for a hit on the Load 
; loose item. It is called from afunO_4 above. 


j 
load_hit bsr.s ld_pass_1 Count the entries for the menu 


bne.s ld_exit Oops, an error occurred 
bsr ld_pass_2 Build the menu 
ld_exit rts Done, DO = error or not 


rts 


moveq #0,d0 
rts 


The main meat of the hit code is yet lo be writlen, however, assembling the above and executing it 
shows thal when the ‘Load’ loose item is hil, both it and the “Save’ one become available. Nothing will 
happen if you now hil or do the ‘Save’ loose item because it still has a dummy hit routine that does 
nothing, other than to reset the loose item fo available. If you have a slow QL, you might see the 
‘Save’ loose item flash as it has ils status reset from selected to available. 


An important point to note. The setting of the Iwo loose ilems to available by a single MOVEW 
instruction only works because ws-_litem is defined as even. its value is $40 and, as | already know 
that li_load is also even, then the MOVEW works. If either of these {or for that matter, Ai) were odd, 


there would be an address exception on a standard QL, bul not on QPC. If you ever wish to add extra 
loose ilems to this utllily, and want to be exira safe, then change the single MOVEW above, fo the 
following: 


move.b #wsi_mkav,ws_litem+li_load(a1) Make Load available. 
move.b #wsi_mkav,ws_litem+li_save(ai) Make Save available. 


We need to add a couple of helper routines next, and then, we can hook them up to Id_pass_i 
replace the dummy code we have there at present 


As we have to scan each line of the _sym_lst file for the characters "+" in both passes, it's probably 
wise fo extract the code to a separate sub~routine. However, there's a slight problem. In the first pass 
we are simply counting entries so that we can allocate the correct amount of memory to build the 
menu, while in pass 2 we have to extracl all the names and offsets to actually use in the menu. What 
to do? 


The answer is simple, if we set an address register to the address of a sub-routine to carry out the 
required work, we can use the JSR (An) instruction each time we find the required text. That way, each 
pass will set the register to a different address and whalever code is at that address when we find a 
line containing a code offset, will be executed. Simple! 


The following code is our equivalent of INSTR. You should type it in just above where ld_pass_2 is 
currently located, 


} LD_INSTR - scans each line of the buffer at (A1) looking for the 
7 characters '*+' and if found, calls the code at the 
; address in A2 


Entry Registers: 


A1.L Buffer to search. Normal QDOS format of word and bytes. 
A2.L Address of code to be called on a "find". Zero if nothing. 


E 


Exit Registers: 


A1.L Address in buffer of the character after the '*' we looked for, 
if found. Points at the '+'. If not found, one past the buffer 
end if not found. 


DO.L O = Found the '#+', 
~1 = Not found. 
~-ve = Appropriate error. 


Flags Z set according to DO. 


- 
1d_instr moveq #0,40 Need DO.L to be zero 
move.w (ai)+,d0 Grab the word count 
beq.s ldi_done Unlikely, but you never know! 
bra.s ldi_next Decrement before comparing 
ldi_scan empi.b #'*', (al)+ Compare and increment 
ldi_next dbeq d0,1ldi_scan Try again or drop out 


; If we get here we have either found a '*' or we haven't. If DO.W is 
j -1 then we didn't find it. Otherwise the 2 flag should be set. 


pne.s ldi_exit Bale out, DO = -1 = not found 
-empi.b #'+', (al) Compare, but don't increment 
bne.s ldi_next Keep searching (unlikely!) 


empa.1 #0,a2 Anything to execute? 

beq.s ldi_exit No, bale out DO = 0 = found 

jsr (a2) Yes, call the code 
a ee ne ae eee ree eee ee ee ee ee ee ee! 
; A not found means we arrive here with DO.W = -1 instead of DO.L. We 
3 must extend DO.W to a long or the calling code will barf! 
oe eee mI eI lEse aa me tae 
ldi_exit ext.1 dO Must exit with error code in DO.L 


ldi_done rts Done 


As you can see it's quite simple. We are passed a buffer address in AL and a code address in A2L. 
DO is ‘set lo the word count for the size of the data in the buffer, and then we enter a loop to search 
for the required *’ character in the buffer. If we hit the end of the buffer DO will be -1 and the Z flag will 
not be set, so we exit directly to the RTS instruction at Idi-done which means we relurn -1 as a flag 
that we didn't find anything. 


Note thal in the event that we don't find the *' we are looking for DO.L holds the value SOOO00FFFE 
The calling code adds | to DOL to determine if it was a not found or some other error, so we have to 
make sure that DOL holds $FFFFFFFE 


The code at Idi_exit does this, but also does it when we have found it, whether or not we call any 
code in A2, so in that case, it’s an un-required instruction. However, it does nicely set the flags for us 
so we don't have to TSTL DO on the way out. 


If we do find an ‘*’ character, we exit from the bottom of the loop with the condilion codes set to ‘eq’ 
(the same condition as the ‘cc’ part of the Dbcc instruction) so we know we found it. ALL is pointing at 
the character after the * and we hope that it is a ‘+’. Ifit is not a plus, then we skip back into the loop 
to see if there are any more '*’ characlers. This is unlikely in a _sym_lst file, but you never can be too 
sure! 


Assuming the character at ALL is a plus, we check if A2L is zero and of so, exit setting DO lo zero to 
indicate found. If A2.L holds some other value, we call the code pointed to by A2L and, on return, 
make sure the flags are set according to any potential error codes in DO, and_-exit. 


We are now ready to write the code to replace the dummy code at Id_pass_t. 


ld_pass_1 
lea sym_buffer,a0 File name 
psr f_open_in File must exist already for reading 
bne sui Error exit, dramatic and fatal! 
moveq #0,a7 Counter register 
lea 1d_pi_count, a2 Call back code to do the counting 
pl_entry moveq #128,d2 Size of buffer space. (Preserved) 
moveq #~1,43 Timeout (Preserved) 


The main entry point to pass atlempts lo open the file who's name is currently stored in the sym file 
buffer. Hf it fails to open for any reason, I'm alraid the application simply dies. This is nol ideal and in a 
‘commercial’ quality application this would simply be unacceptable. | only do it here to reduce space in 
the magazine. 


Note: | do know how irrilaling it can be for a program to just vanish. During testing | had a bug thal 
caused the program to quit whenever a line didn't contain an asterisk, The reason was that DOL held 
SOOOOFFFF and not $FFFFFFFF on exit from Id_instr. 


The next slep is to zero D7 which is acting as our counter, The whole of D7L is set to zero although 
the code only requires the low word. A2L is loaded with the address of the callback routine that does 
the counting for us. Every time there's a hit in the data read from the _sym_lst file, we jump lo the 
code whose address Is held in A2.L. On this pass, it simply counts. (See below) 


Pl_eniry is the second entry point to this code. There's no point duplicating huge chunks of code, and 
as pass | and pass 2 are both required to read the file, and scan each line of text read from it, we can 
use the code in pass 1 as part of pass 2. Pl_eniry will be where pass 2 joins in with the fun. 


At this point, we have everything initialised for pass 1. The buffer length for IO_FLINE is set as is the 
timeoul. These two registers are preserved through the calls to IO_LFLINE so can be initialised once 
only, prior to the start of the main loop for each pass. 


pi_loop lea pi_buffert+2,al We need to reinitialise the each time 
; AO.L already has the channel id 

j D2.W already has the buffer size 

j . D3 already holds the timeout 


moveq #io_fline, 40 The trap code we desire 
trap #3 Read up to 128 bytes ending with a if 
tst.1 dd Errors? 
beq.s pi_not_eof No, all ok, skip 
pleof cmpi.1 #-10,d0 Was it EOF? 
bne sui No, error, die horribly! 
bra.s pl_exit Must be EOF, all done for pass 1 
pi_not_eof 
subq.w #1,d1 Lose the terminating 1f character 
beq.s pi_next Nothing to do here, empty line 
lea pi_buffer,al Buffer address again 
move.w di, (ai) Make into QDOSMSQ string 


The first part of the main loop sets ALL to the third character of the buffer we will use to read each 
line of data from the _sym_ist file into. IOLFLINE fetches bytes, not a QDOSMSQ string with a word 
count, so we cannot simply point Al at the start of the buffer 


We call {O_FLINE fo read some text up to a maximum of 128 bytes, bul normally terminating with a 
linefeed character. On return, if DOL is EOF we exit as this concludes pass 1. If DOL is holding any 
other error code, the application simply takes Ihe easy way out and dies horribly. 


The number of characters read, including the linefeed is returned in DIW from which, we subtract 1 to 
lose the trailing linefeed. We skip to the end of the loop if the length is now zero as we can't scan an 
empty string. If there is work to do, we reset ALL to the word count at the start of the buffer and store 
the length word, now not including the linefeed. We are now ready to scan the {resh data in the buffer, 


psr.s ld_instr Scan for the required characters 
beq.s pi_next We found it, do next line of data 
addq.1 #1,d0 Minus 1 was not found 
bne sui Oh dear, some other error. Die 
pi_next bra.s pl_loop Let's go round again 
plexit moveq #0,d0 No errors. We come here from EOF only 
rts 


The above code calls the ‘insir’ code to look for the two desired characters. |{ found, DOL will be zero 
on return. In that case, we skip to the bottom of the main loop ready to go round again. If DOLholds 
minus | then thal indicates not found, which isn’t an error, so we will also go around again until we hit 
EOF Any other errors cause the application to die horribly as usual. (I really don't like that!) 


pi_buffer 
ds.w 65 


128 bytes + a word count 


The code above reserves a 65 word buffer which allows for 128 characters and a word count. This 


will be ample for our needs. 


We must also write the call back routine that does the pass | counting. 


i 
3 LD_P1_COUNT - called from LD_INSTR during pass 1 when we find the 
4 required '*+' characters in the buffer. All we do is 


; increment a counter, in D7.W 


; Entry Registers: 


; Al.L Pointer into search buffer. Points at the '+' character. 


? 

} 

; D7.W Counter of hits so far. 

, 

3 A2.L Address of 1ld_pi_counter. 


Exit Registers: 


; DO.L Zero. 


? 
’ 
3 D7.w Incremented by one from the entry value. 
? 
’ 


; Flags Z set. 


addq.w #1,d7 
moveq #0,d0 
rts 


Simply increment the counter 
No errors. Sets % flag. 


The code can be assembled and executed. You are now able to enter a sym file name, and load it. 
Well, you are able lo carry out pass 1 of the load process which does nothing much except count the 
required entries we will need in the application sub- window menu. 


Next time, we will add in pass 2 to build and display the menu. 


l2C Imteriace tor QL Emulators 


MI2 Black Box QUs) 


Part 7/ (and mow for arom 


Some of you may have been put off by the cosl 
of the By-Vac BV4221-V2 since, at the time of 
wriling, this device costs £24.50. Another down 
side of this device is that it will only work with PC 
based emulators since it uses the USB port. So 
is there another way? Yes there is, it is cheaper - 
al least the main hardware solution - and will 
work with ‘Black Box’ QL's. However you will 
have {o construct it, program a PIC micro- 
processor and provide a 5VDC regulated supply, 
So there is more work involved. But this is a 
really good way of using that old QL you have 
hidden away. | am using one as a model railway 
layout controller. Without delving {at least loo far} 
inlo the ‘Black Box’ itself, As to the BT connec- 


— [by lan Burkinoshany 


lors used on standard UK QL's please see my 
comments in QLT 17, Issue 2, page 9. 


The cost of the main active components is as 
follows: 


From Farnell 


PIC12F67/51/P 9759018 £1.08 
MAX232CPE+ 9725172 £3.67 

From Rapid 

PIC12F6/5I/P 73-3284 = £0.84 
MAX232CPE+ 82-0148 FL4l 

{OuF 25V Cap x4 11-3686’ £0,031 each 
O.luF Cap x 2 08-0235  £0.021 each 


Depending where you purchase the components, 
and adding things like connectors, this converter 
can be buill for around £10. The prices are cor- 
rect at the time of writing, bul there may be mini- 
mum order requirements. Please check carefully 
when ordering parts. 


You need to have the skills to program PIC chips. 
There are several ways of doing this. For exam- 
ple the Microchip PICKii2 made by the manu- 
factures of the PIC micro's themselves, costs 
£32.26 from Farnell. An alternative is the Velleman 
kit (K8048) at £34.99 from Maplin. The Vellema 
kil is limited in the range of PIC devices it can 
program. However it will program the PIC12F675 
as used in this converter and also the PICI6F84 
as used in the PS2 mouse lo game port con- 
verter by flyergio from Italy (see my review in 
QLT 17, Issue 2). The Velleman kit is very good i 
you want to learn more about PIC’s, since it is a 
programmer and development board, so you 
lakes your choice. | have bolh these devices and 
they work very well. This does add to the overal 
cost, bul is a good investment for other PIC 
based projecls and to learn more about PIC 
devices. 


There is a third (the cheapest) solution called WIN 
PIC. This ts a PC based programmer, like the 
ones above, but wilh fairly simple hardware 
which you can make on some strip board. WI 
PIC will program a wide variety of PIC devices. 
including the PICL6F84A for the PS Mouse pro- 
ject and the PIC12F675 for this project. Use the 
circuit diagram alt 

http://www.qsl.net/di4yhf/winpic/index.htm#eprom_prog. 


Since this has a better 
arrangement for the al 


important program: | 
ming voltage. The 
power for the pro- 


gramming vollage can 
be provided with two 
(R22) PP3 batteries 
connected in series to 
give a vollage o 
about 18 volts, the on 
board regulator then 
reduces this to the 
required {2.7 volts for 


programming the 

PIC's. All the PC software and information for this 
programmer can be found al 
http://www.qsi.net/di4yhf/winpicpr.html. Scroll down 


the page until the WIN PIC manual for the user 
manual. You will find the software download 
further down the opening page. 
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have tested the WIN PIC programmer on both 
the 'PS Mouse’ and the 'RS232 to |2C’ projects 
and it works with no problem. 


You will also need Microchips MPLAB IDE deve- 
lopment tool, this is free to download from Micro- 
chips web site, please see below for link. Be 
watned this’is a big download. 


In essence this PIC based converter is a RS232 
to 12C converter To use it with a PC based 
emulators such as QPC you will need either a 
RS232 on your PC or a USB to RS232 converter. 
These are available from such places as Maplin’s. 
You may already have one of these. So again this 
may add to the cost. So the ByVac product could 
still be the best answer for you, if you don't have 
a USB to RS232 converter or PIC programmer. 


So to the RS232 to 12C converter itself, The 
hardware and firmware for this project was 
developed by Andrew M Bishop. He is, as far as | 
know, not a QL user This project was originally 
designed for Linux and PC based projects. See 
his web site for more information. You will also 
find other RS232 based converters as well, such 
as for PS2, SPI and Infra Red device. Which you 
may find of interest, but | will only be dealing with 
the [2C this time. 


The nice thing about Andrew's projects is that all 
the source code as well al the compiled hex files 
are available in his amb-pic-code file. See below 
for the link for this. So you can see how these 
things work and make any changes you want for 
your OWN PUrpOses. 


Below, an image of the RS232 to I2C converter 


In its original form the converter works al 38400 
baud, which is fine for emulator users like QPC2, 
but is far to fast for ‘Black Box’ QL users. So | 
have modified Andrews code to work at 9600 
baud. | will explain how you change Andrews 
code. 


The circuil diagram below shows the complete 
project, it breaks down into three parts. The PIC 
which does all the clever stuff and does the 


conversion work. This is the 


top left integrated 


circuit with just the PIC and three resistors and a 


diode. For PICKit2/3 users 


have shown the 


connections for the programmer. Second is the 
MAX232 which is a level converter to change 
the +5v signals to and from the PIC lo the +/- 8 


volts required for the RS232 


interface, this is the 


In Circuit Pragraming Cannector For PICKit273 


1=Vpp (Programing Voltage) 
2=Vdd (No Conection) 

3=GND 

4=PGD (Programing Data) 
S=PGC (Programing Clack)? 


integrated circuit and associated components, 


lop right. Th 
which show 
lines, this is 


e third and final part is a LED monitor, 
s the traffic on ail the 12C and RS232 
optional. | just put this in for my own 


testing purposes. For this project to work you 


just need 


he PIC and MAX232 parts of the 


circuit in the top diagram below. Unlike the 


BV4221 whi 
connection, 
to this circu 


it 


ch received its power from the USB 
you need a regulated 5VDC supply 
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As you can see it is very simple, with a low com- 
ponent count. There are not even any crystals, 
since the PIC is programmed to use an internal 
oscillator. 


Using the original hex file program.hex from 
Andrew's library, which you will find in the 
amb-pic-code-2010-09-19/1s232-i2c directory, 
Then just follow the instruction for your PIC pro- 
grammer. This will give a working PIC converter 
thai works at 38400 baud. 


This high baud rate is fine if you just want to use 
this converter with QPC2. However this is far to 
fast for a ‘Black Box QL’. The maximum speed 
with a standard QL is 9600 baud. Now to change 
the baud rate from 38400 to 9600 you will need 
the MPLAB IDE. So download this from the Micro- 
chip web site and install it on your PC. No choice 
here has to be a PC. 


Now to make things a little easier to understand | 
put all the required files to compile the PIC code 
in one directory. They are listed below you will 
find them in the amb-pic-code~2010-09-19/ 
rs232-i2c directory and the amb-pic-code- 
2010-09-19/common directories. 


Delay. ine 
Delay_cycle.ine 
Delay_ms.ine 
Delay_us.ine 
Eeprom. ine 
Generic. ine 
I2c. ine 
I2e_basic.ine 
I2c_master. ine 
I2c_slave. ine 
T2c_ssp.inc 


I2c_ssp_basic. ine 
I2c_ssp_master. ine 
I2x_ssp_slave.inc 
Reset_device. inc 
Rs232. ince 
Rs232_basic.ine 
Rs232_rx. ine 
Rs232_time. ine 
Rs232_tx. ine 
Program.asm 


Itis best to load the elements above into MPLAB 
IDE to edit and then save them. You could do this 
in Notepad, but the layout will not be very clear. 
Just go though all the above RS232 files and 
change any entry from 38400 to 9600. Recom- 
pile the code. ff you do not want to do this then | 
have made available the hex file, which runs at 
9600 to the editors of QLoday. 


So that is the hardware now the software. The 
protocol for this converter is different from the 
BV4221 we have discussed during this series. 


The commands are as follows— 


START = 'g! 
STOP = 'p! 
RESET = 'R! 
WRITE COMMAND = 'w' 
WRITE DATA = 'x! For use with EEPROMS 
READ COMMAND = 'r! 
READ DATA = ‘s' For use wilh EEPROMS 


State machine that is implemented here. 


(Brackets show error number if expected state is 
NOT reached) 


START 


WRITE~ 


(2) 


(4) 


STOP 


State Machine 


Y 
RESTART 


So the order of commands should look something like this : 


‘S'TART, write n bytes, STO'P! 

or 

'S'TART, write n bytes, 'R'ESTART, read m bytes, STO'P! 

A simple example SB program ts show below, which is fully commented, this can drive a PCF8574A in 
output mode : 

10 REMark RS232 to I12C test 

20 CLS 

30 BAUD seri1,9600:REMark Sets the baud rate for the RS232 to I2C Converter, either 


180 
190 
200 
210 
220 


9600 or 38400, depending on how the PIC has been programmed 
OPEN#3;ser1:REMark opens the required serial port. 

PRINT#3; CHR$(83);:REMark HEX='53',ASCII code='S' for START I2C command 

PAUSE 10:REMark Delay to allow the PIC to process the data and be ready for the 
next character 

PRINT#3; CHR$(119); :REMark HEX='77', ASCII code="w" write to I2C device 

PAUSE 10 

PRINT#3; CHR$(2); :REMark HEX='02' number of bytes to follow. 

PAUSE 10 

PRINT#3; CHR$(126);:REMark HEX='7E', ASCII='~! the I2C device address. 

PAUSE 10 

PRINT#3 ; CHR$(129);:REMark DATA to be sent to the I2C device (0 to 255). 
PAUSE 10 

PRINT#3; CHR$(80); :REMark HEX='50', ASCII='P! for the STOP I2C command 

PAUSE 10 

FOR a=0 TO 2: REMark This FOR NEXT loop reads the return which is sent after 
the STOP command has been sent to the RS232 to I2C converter.The return from 
RS5232 to I2C converter should be 'OK' if all is well. This also where the 
errors will be returned if this go wrong, see State Machine above to help with 
debugging. 

a$=INKEY$(#3) 

IF ag=""" THEN GO TO 180 

PRINT a$; 

NEXT a 

CLOSEH3 


| will leave it you to try reading data back from a device and amending my previous programs as you 
require. 


| would like to thank Andrew M Bishop's help in the preparation of this article and his permission to 
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QUANTA AGM 

QL Today was unable to give details of the 
Quanta AGM in the main news section - the edi- 
tor did not receive his copy of the December/ 
January Quanta Magazine. 


The Workshop and AGM will be held in the usual 
venue in Manchester on 13th and 14th April, This 
is the third consecutive year the AGM has been 
held in Manchester, which offers the cheapest 
venue for a show with considerable savings on 
hiring costs and committee expenses. Last year 
the AGM cost Quanta £110, but a venue 
elsewhere would cost £500 to £1,000. In 2009 
and 2010 Quanta held the AGM at central 
locations in the Midlands, but attendance was low. 


This year Quanta is allowing electronic participa- 
tion in the AGM via Skype in accordance with the 
new provision in the constitution. Earlier this year 
a committee meeting was held with one member 
participating via Skype. 


Quanta is stil having problems with members 
who formerly paid their subscription by standing 
order Many have continued to pay at the old 
subscription rate and several have not replied to 
Quanta’s letters on the matter On advice from 
the auditor, their payments were temporarily 
placed in a suspense account before being 
treated as donations to Quanta. The result is a 
sharp, but not unexpected, fall in membership 
from 175 to 151. However there has been a sharp 
rise in the number of members opting to receive 
the electronic version of the magazine. 


Some time passed by since | called Geoff and 
discussed the situation, Time passed by since | 
wrote down the reason for the decision. 


Now | am on page 53 .. wow, 54 pages total 
again although the calculation was based on 32 
pages. 

| have to admit it was a pleasure to lay it out .. 
very interesting stuff, as most of the time. 


| am still missing some kind of ‘relief’ or ‘stress 
burden taken from me’ feeling .. probably 
because producing QL Today was nothing | 
would consider as ‘pain’ .. it has taken a lot of 


Quanta is redesigning its website following the 
transfer to a cheaper host. 


SMSQmulator 
A slight addition to the article on SMSQmulator 
on page 12. 


When you reconfigure SMSQmulator to high 
colour mode, you may have to also increase the 
memory required to ensure that the QJewels 
program displays correctly, 


Karl llletschko from Austria is searching for 
German QUASAR magazines. He is rather flexi- 
ble about how to obtain them - if somebody 
wants to get rid of them, he is happy to take 
them - pay for shipping and/or pay something for 
the magazines. 

lf somebody can lend him issues so that he can 
photocopy them, he'd be happy too. 


Or if somebody could send him scans or photo- 
copies - that would be helpful as well, 


Whichever option is possible, Karl is looking 
forward to it. 


You can contact him via EMail 
outsider@netway.at 


time, to produce (both the layout and the physical 
production until it was shipped). Which is very 
good in some way. Not that | will revert my 
decision - there are too many other factors which 
make it impossible to continue. 


So let's prepare for the final issue. Once again, 
material is most welcome. We do not want to get 
{00's pages of praise (although we feel we did a 
good, reliable job over the {7 years) - let's try to 
produce a final, interesting issue at the normal 
quality level. If you have not written anything in 
the past, why nol drop us a few lines now.? 


So please remember: 


Deadline for letters, articles, 
_ reviews etc. extended to 
31st of May 2013 


Issue 4 will not be shipped in | 
June - it is scheduled for 
middle of September! 


Have a great summer - 

we look forward to a 
great final issue, | 

combined with a CD or DVD. | 


Your QL Team! 


